Deel: Retrieve a legal entity — 200 response body — data
Retrieve a legal entity: 200 response body, field data. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Retrieve a legal entity — 200 response body — data
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
address | JSON | Optional | |
address (anyOf 1) | Model | Alternative | Expand Retrieve a legal entity — 200 response body — data address city, country, state, street, zip |
address (anyOf 2) | null | Alternative | |
archived_at | JSON | Optional | |
archived_at (anyOf 1) | string | Alternative | The timestamp when the legal entity was archived, if any. Format: date-time |
archived_at (anyOf 2) | null | Alternative | The timestamp when the legal entity was archived, if any. Format: date-time |
cdd_status | JSON | Optional | The raw CDD verification status. When verification has not started it is coalesced to a tier-dependent initial value: PENDING when CDD is required, NOT_REQUIRED for Tier-0/SaaS entities. |
cdd_status (anyOf 1) | string | Alternative | The raw CDD verification status. When verification has not started it is coalesced to a tier-dependent initial value: PENDING when CDD is required, NOT_REQUIRED for Tier-0/SaaS entities. Known values: NOT_REQUIRED, PENDING, PENDING_ASYNC_TASKS, DRAFT, SUBMITTED, APPROVED, REJECTED, EDD |
cdd_status (anyOf 2) | null | Alternative | |
country | JSON | Optional | |
country (anyOf 1) | string | Alternative | The country of the legal entity (ISO 2-letter code). |
country (anyOf 2) | null | Alternative | The country of the legal entity (ISO 2-letter code). |
created_at | string | Optional | The timestamp when the legal entity was created. Format: date-time |
entity_type | JSON | Optional | |
entity_type (anyOf 1) | string | Alternative | The entity subtype. |
entity_type (anyOf 2) | null | Alternative | The entity subtype. |
id | string | Optional | The unique identifier of the legal entity. |
incorporation_date | JSON | Optional | |
incorporation_date (anyOf 1) | string | Alternative | The incorporation date of the legal entity. Format: date |
incorporation_date (anyOf 2) | null | Alternative | The incorporation date of the legal entity. Format: date |
industry_name | JSON | Optional | |
industry_name (anyOf 1) | string | Alternative | The industry name of the legal entity. |
industry_name (anyOf 2) | null | Alternative | The industry name of the legal entity. |
legal_name | JSON | Optional | |
legal_name (anyOf 1) | string | Alternative | The registered legal name of the entity. |
legal_name (anyOf 2) | null | Alternative | The registered legal name of the entity. |
legal_type | JSON | Optional | The legal type of the entity. |
legal_type (anyOf 1) | string | Alternative | The legal type of the entity. Known values: individual, company, light |
legal_type (anyOf 2) | null | Alternative | |
name | string | Optional | The name of the legal entity. |
phone | JSON | Optional | |
phone (anyOf 1) | string | Alternative | The phone number of the legal entity. |
phone (anyOf 2) | null | Alternative | The phone number of the legal entity. |
registration_number | JSON | Optional | |
registration_number (anyOf 1) | string | Alternative | The registration number of the legal entity. |
registration_number (anyOf 2) | null | Alternative | The registration number of the legal entity. |
status | string | Optional | The mapped legal entity lifecycle status. Known values: archived, active, draft, processing, processing_draft, pending_verification, awaiting_review, unknown |
updated_at | string | Optional | The timestamp when the legal entity was last updated. Format: date-time |
vat_id | JSON | Optional | |
vat_id (anyOf 1) | string | Alternative | The VAT identifier of the legal entity. |
vat_id (anyOf 2) | null | Alternative | The VAT identifier of the legal entity. |
Referenced models: Retrieve a legal entity — 200 response body — data address city, country, state, street, zip