List Legal Entity Registration Documents

GET

/legal-entities/:legal_entity_id/registration-documents

GET

/rest/legal-entities/:legal_entity_id/registration-documents

$ curl -G https://api.letsdeel.com/rest/legal-entities/c106a26a-21bb-5538-8bf2-57095d1976c1/registration-documents \
>      -H "Authorization: Bearer <token>" \
>      -d limit=20 \
>      -d cursor=YzEwNmEyNmEtMjFiYi01NTM4LThiZjItNTcwOTVkMTk3NmMx \
>      -d search=incorporation \
>      -d status=AWAITING_REVIEW \
>      -d product_type=GLOBAL_PAYROLL \
>      -d requirement_id=c106a26a-21bb-5538-8bf2-57095d1976c1 \
>      -d only_archived=false

1 {
2   "data": [
3     {
4       "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
5       "status": "AWAITING_REVIEW",
6       "files": [
7         {
8           "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
9           "original_filename": "certificate_of_incorporation.pdf",
10           "uploaded_at": "2026-08-17T09:30:00.000Z",
11           "content_type": "application/pdf"
12         }
13       ],
14       "parent": {
15         "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
16         "status": "REJECTED"
17       },
18       "children": [
19         {
20           "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
21           "status": "AWAITING_REVIEW",
22           "files": [
23             {
24               "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
25               "original_filename": "certificate_of_incorporation.pdf",
26               "uploaded_at": "2026-08-17T09:30:00.000Z",
27               "content_type": "application/pdf"
28             }
29           ],
30           "archived_at": "2026-09-01T08:00:00.000Z",
31           "reviewed_at": "2026-08-18T11:00:00.000Z",
32           "submitted_at": "2026-08-17T09:30:00.000Z",
33           "rejection_reason": "Document is illegible"
34         }
35       ],
36       "archived_at": "2026-09-01T08:00:00.000Z",
37       "requirement": {
38         "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
39         "name": "Certificate of Incorporation",
40         "description": "A copy of the certificate issued at registration.",
41         "is_disabled": false,
42         "has_template": false,
43         "product_type": "GLOBAL_PAYROLL",
44         "applicable_at": "BEFORE_FIRST_PAYROLL",
45         "reference_url": "https://example.gov/certificates",
46         "is_approval_required": true,
47         "is_submission_required": true,
48         "how_the_document_is_used": "PAYROLL_PURPOSE",
49         "why_the_document_is_needed": "Required to register the entity for payroll.",
50         "how_client_obtains_document": "Download it from the companies registry."
51       },
52       "reviewed_at": "2026-08-18T11:00:00.000Z",
53       "legal_entity": {
54         "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
55         "name": "Acme BV",
56         "country": "NL"
57       },
58       "submitted_at": "2026-08-17T09:30:00.000Z",
59       "rejection_reason": "Document is illegible",
60       "submission_due_date": "2026-09-30T00:00:00.000Z",
61       "archived_submissions_count": 2
62     }
63   ],
64   "has_more": true,
65   "next_cursor": "YzEwNmEyNmEtMjFiYi01NTM4LThiZjItNTcwOTVkMTk3NmMx",
66   "total_count": 124
67 }

Lists the registration documents required from a legal entity, together with what has been submitted and how far through review it is. Use this to find out what is still outstanding before a first payroll, or to reconcile submission status. Requirements that have not been answered yet are included with a null id.

Token scopes: legal-entity: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

## 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)

AuthorizationBearer

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

Path parameters

legal_entity_idstringRequiredformat: "uuid"

Public UUID of the legal entity.

Query parameters

limitintegerOptional1-100Defaults to 20

Maximum number of results to return per page.

cursorstringOptionalformat: "^[A-Za-z0-9_-]+$"<=2048 characters

Pagination cursor returned as next_cursor by the previous response. Omit for the first page.

searchstringOptional<=255 characters

Free-text search on the requirement name.

statuslist of enumsOptional

Filter by submission status. Repeat the parameter to pass several values.

product_typelist of enumsOptional

Filter by the product the requirement applies to. Repeat the parameter to pass several values.

Allowed values:

requirement_idlist of stringsOptional

Filter to specific requirements. Repeat the parameter to pass several values.

only_archivedbooleanOptionalDefaults to false

Return superseded submissions instead of the current ones.

Response

Documents returned successfully.

datalist of objects

Documents for this page.

has_moreboolean

Whether another page of results is available.

next_cursorstring or null

Cursor to pass as cursor for the next page. Null when there are no more pages.

total_countinteger>=0

Total number of matching documents.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'