Get Legal Entity Registration Document

GET

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

GET

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

$ curl https://api.letsdeel.com/rest/legal-entities/c106a26a-21bb-5538-8bf2-57095d1976c1/registration-documents/c106a26a-21bb-5538-8bf2-57095d1976c1 \
>      -H "Authorization: Bearer <token>"

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

Returns a single document submission, including its review status, attached files and any superseded revisions. Use this to poll one submission after uploading, rather than re-listing every document for the entity. Archived submissions are returned by this endpoint as well as active ones.

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.

document_idstringRequiredformat: "uuid"

Public UUID of the document submission.

Response

Document returned successfully.

dataobject

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'