Skip to navigation

List tax forms for the authenticated worker

List the tax forms of the worker resolved from the access token, ordered by creation date descending, using cursor pagination (limit + cursor). Each item contains the resource fields (id, created_at, updated_at, client_legal_entity_id, pdf_url) and the full form data in the same public shape the create endpoint accepts; the fields present depend on the item’s form_type. Each form appears once, carrying its current data. Tax identification numbers are unmasked because the authenticated worker owns the data.

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 -X GET 'https://api.letsdeel.com/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/

Query parameters

limitintegerOptional1-100Defaults to 20

Maximum number of tax forms to return per page (1-100).

cursorstringOptional

Opaque pagination cursor returned as next_cursor by a previous page. Omit to fetch the first page.

Response

A page of the worker's tax forms.
datalist of objects
The worker's tax forms, newest first.
has_moreboolean
Whether more tax forms exist beyond this page.
next_cursorstring or null

Cursor to pass as the cursor query parameter to fetch the next page. Null when has_more is false.

total_countinteger
Total number of the worker's tax forms across all pages.

Errors

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