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>"

{
  "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
  }
}

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

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