Add Files To Legal Entity Registration Document

PATCH

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

PATCH

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

$ curl -X PATCH https://api.letsdeel.com/rest/legal-entities/c106a26a-21bb-5538-8bf2-57095d1976c1/registration-documents/c106a26a-21bb-5538-8bf2-57095d1976c1 \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "data": {
>     "files": [
>       {
>         "file_id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
>         "content_type": "application/pdf",
>         "one_time_secret": "a1b2c3d4e5f6",
>         "original_filename": "certificate_of_incorporation.pdf"
>       }
>     ]
>   }
> }'

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 }

Attaches more files to an existing submission, keeping the files already on it. Use this when a document was submitted incomplete — a missing page or an extra supporting file — and it is still awaiting review. To replace a rejected submission outright, use the replace-files endpoint instead.

Token scopes: legal-entity:write

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.

Request

This endpoint expects an object.

dataobjectRequired

Response

Files added successfully.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

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