Skip to navigation

Retrieve payment receipts

Returns a cursor-paginated list of payment statements to Deel, including status, totals, currency, and payment method. Child invoices and per-worker details are no longer included in this response; use GET /rest/payments/{payment_id}/breakdown to retrieve them. Use the next_cursor value from the response to retrieve subsequent pages.

Token scopes: accounting:read

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

curl -X GET 'https://api.deel.training/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

OR
AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Headers

X-VersionstringOptionalformat: "^\d{4}-\d{2}-\d{2}$"Defaults to 2026-06-16

Version of this endpoint to call (YYYY-MM-DD). This reference documents version 2026-06-16. When the header is omitted the API serves the oldest version that is neither beta nor sunset, which can be an older version with a different contract than the one documented here.

Query parameters

date_fromstringOptionalformat: "date"

Filters results to include payments created on or after this date (in ISO 8601 format).

date_tostringOptionalformat: "date"

Filters results to include payments created before this date (in ISO 8601 format).

cursorstringOptional

A cursor for pagination. Use the value returned in the ‘next_cursor’ field to get the next page of results.

currencieslist of stringsOptional
Filters payments by their currency codes. Can be a single currency code or an array of codes.
entitieslist of enumsOptional

Filters payments by legal entity type (e.g., ‘individual’ or ‘company’). Can be a single entity type or an array.

Allowed values:
statuseslist of enumsOptional

Filters payments by their status (e.g., ‘paid’ or ‘processing’). Can be a single status type or an array.

Allowed values:

Response

Successful operation.
dataobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error