EndpointsWorkers

Retrieve worker transaction history

Use this endpoint to access a worker’s transaction history quickly. This integration works with white-label clients and ensures compliance by not following the generic contractor route Token scopes: worker: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 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)
OR
AuthorizationBearer
Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

limitintegerOptional1-1000Defaults to 100

Maximum number of transactions to return in this page (page size).

filterenumOptionalDefaults to ALL

Subset of transactions by processing state. Public enum is UPPER_SNAKE; the server lowercases for validation (legacy lowercase query values are still accepted).

Allowed values:
fromstringOptionalformat: "date-time"

Lower bound on transaction created_at (inclusive), ISO-8601 date-time.

tostringOptionalformat: "date-time"

Upper bound on transaction created_at (inclusive), ISO-8601 date-time.

cursorstringOptional

Opaque pagination cursor from the previous response field next_cursor. Omit on the first page; pass the last next_cursor value as cursor to fetch the next page.

statuseslist of stringsOptional

Filter listed transactions to these mapped status values (applied after fetch; may affect how rows align with total_count).

amount_fromdoubleOptional>=0
Minimum transaction amount to include.
amount_todoubleOptional>=0
Maximum transaction amount to include.
currencieslist of stringsOptional
Only include transactions in one of these currency codes.
transaction_typeenumOptional

Restrict to pay-in or pay-out. Public enum is UPPER_SNAKE; the server lowercases for validation (legacy lowercase query values are still accepted).

Allowed values:
withdrawal_methodslist of stringsOptional

Filter by withdrawal / payout method identifiers.

last_daysintegerOptional
Only include transactions created in the last N days.
typestringOptional<=100 characters

Additional transaction type filter (backend-specific string).

include_running_totalbooleanOptionalDefaults to false
When true, each row may include a running total over the result set.

Response

Successful operation — paginated contractor transactions.

datalist of objects
Transaction rows for this page.
has_moreboolean
Whether another page exists after this one.
total_countinteger>=0

Total number of transactions matching server-side filters for this request (ignores pagination). If statuses is provided, that filter is applied in memory to listed rows only, so this count may be higher than the rows returned across all pages.

next_cursorstring or null

Opaque cursor for the next page; null when there is no next page. Pass this value as the cursor query parameter to request the following page.

Errors

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