Skip to navigation

List Monthly Salary

Returns one staff member’s payroll month by month, as last computed and stored by SalaryBox (the finalized one when the month is finalized). Requires Payroll Pro. Inactive staff can be fetched. Not paginated.

  • This never computes payroll. A month nobody computed has is_computed false and its figures are null.
  • Months are listed oldest first, one for every month in the range.
  • total_deductions includes pay cuts, as on the payslip.
  • For every staff member’s net pay, amount paid or amount due, use List Payroll History.

Authentication

AuthorizationApi-Key

Format: “Api-Key {api-key}”

Query parameters

salarybox_idstringRequired
The staff member to return.
from_monthstringRequired

First month to include, YYYY-MM.

to_monthstringRequired

Last month to include, YYYY-MM. Cannot be in the future. The range can cover at most 6 months.

Response

The staff member's identity and one entry per month.
messagestring
statusboolean
dataobject

Identity fields shared by per-employee payroll responses.

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error