Get payment data for a pay date

This endpoint returns payment data for a pay date or a pay period: one entry for each payment that was paid on that date, or calculated for that pay period, with the full detail of the payment – wages, taxes, additional costs, deductions, and net payouts.

Use it to reconcile payroll after it has been processed, post payroll to your general ledger, or build your own payroll reports, with every figure itemized at the payment level.

Specify either pay-date, or both pay-period-start-date and pay-period-end-date. Sending both, or only one of the pay period dates, is an error.

Results are paginated with a cursor. Pass the nextCursor from each response as the after parameter of your next request until hasNextPage is false. See the Payment Data API Guide for all the details about how this API works.

Query Params
date

The pay date to retrieve payments for, in the format YYYY-MM-DD. Specify either pay-date or both pay-period-start-date and pay-period-end-date, not both.

date

The start date of the pay period to retrieve payments for, in the format YYYY-MM-DD. Must be sent together with pay-period-end-date, and instead of pay-date.

date

The end date of the pay period to retrieve payments for, in the format YYYY-MM-DD. Must be sent together with pay-period-start-date, and instead of pay-date.

integer
1 to 1000
Defaults to 200

The maximum number of payments to return on a page. Defaults to 200 and must not exceed 1000.

string

The nextCursor from the previous page, to retrieve the page after it. Omit to retrieve the first page.

Responses

400

The pay date is missing or invalid, the limit is out of range, or the cursor is invalid

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json