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 cursor=YzEwNmEyNmEtMjFiYi01NTM4LThiZjItNTcwOTVkMTk3NmMx \
     -d limit=20 \
     -d only_archived=false \
     -d product_type=GLOBAL_PAYROLL \
     -d requirement_id=c106a26a-21bb-5538-8bf2-57095d1976c1 \
     -d search=incorporation \
     -d status=AWAITING_REVIEW

{
  "data": [
    {
      "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
      "status": "AWAITING_REVIEW",
      "files": [
        {
          "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
          "original_filename": "certificate_of_incorporation.pdf",
          "uploaded_at": "2026-08-17T09:30:00.000Z",
          "content_type": "application/pdf"
        }
      ],
      "parent": {
        "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
        "status": "REJECTED"
      },
      "children": [
        {
          "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
          "status": "AWAITING_REVIEW",
          "files": [
            {
              "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
              "original_filename": "certificate_of_incorporation.pdf",
              "uploaded_at": "2026-08-17T09:30:00.000Z",
              "content_type": "application/pdf"
            }
          ],
          "archived_at": "2026-09-01T08:00:00.000Z",
          "reviewed_at": "2026-08-18T11:00:00.000Z",
          "submitted_at": "2026-08-17T09:30:00.000Z",
          "rejection_reason": "Document is illegible"
        }
      ],
      "archived_at": "2026-09-01T08:00:00.000Z",
      "requirement": {
        "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
        "name": "Certificate of Incorporation",
        "description": "A copy of the certificate issued at registration.",
        "is_disabled": false,
        "has_template": false,
        "product_type": "GLOBAL_PAYROLL",
        "applicable_at": "BEFORE_FIRST_PAYROLL",
        "reference_url": "https://example.gov/certificates",
        "is_approval_required": true,
        "is_submission_required": true,
        "how_the_document_is_used": "PAYROLL_PURPOSE",
        "why_the_document_is_needed": "Required to register the entity for payroll.",
        "how_client_obtains_document": "Download it from the companies registry."
      },
      "reviewed_at": "2026-08-18T11:00:00.000Z",
      "legal_entity": {
        "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
        "name": "Acme BV",
        "country": "NL"
      },
      "submitted_at": "2026-08-17T09:30:00.000Z",
      "rejection_reason": "Document is illegible",
      "submission_due_date": "2026-09-30T00:00:00.000Z",
      "archived_submissions_count": 2
    }
  ],
  "has_more": true,
  "next_cursor": "YzEwNmEyNmEtMjFiYi01NTM4LThiZjItNTcwOTVkMTk3NmMx",
  "total_count": 124
}

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

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