Skip to content

Deel: List of legal entities — 200 response body — data item

List of legal entities: 200 response body, field data / item. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: List of legal entities — 200 response body — data item

FieldTypePresenceDescription and constraints
$objectRoot
addressJSONOptional
address (anyOf 1)ModelAlternativeExpand List of legal entities — 200 response body — data item address city, country, state, street, zip
address (anyOf 2)nullAlternative
archived_atJSONOptional
archived_at (anyOf 1)stringAlternativeArchived date
Format: date-time
archived_at (anyOf 2)nullAlternativeArchived date
Format: date-time
countryJSONOptional
country (anyOf 1)stringAlternativeCountry of the legal entity
country (anyOf 2)nullAlternativeCountry of the legal entity
created_atstringOptionalCreated date
Format: date-time
entity_subtypestringOptionalEntity sub type
entity_typeJSONOptionalEntity type
entity_type (anyOf 1)stringAlternativeEntity type
Known values: individual, company, light
entity_type (anyOf 2)nullAlternative
idstringOptionalId of the legal entity
industry_nameJSONOptional
industry_name (anyOf 1)stringAlternativeIndustry name
industry_name (anyOf 2)nullAlternativeIndustry name
namestringOptionalName of the legal entity
phoneJSONOptional
phone (anyOf 1)stringAlternativePhone number
phone (anyOf 2)nullAlternativePhone number
registrationNumberJSONOptional
registrationNumber (anyOf 1)stringAlternativeRegistration number
registrationNumber (anyOf 2)nullAlternativeRegistration number
sic_numberJSONOptional
sic_number (anyOf 1)stringAlternativeSIC Company Identifier
sic_number (anyOf 2)nullAlternativeSIC Company Identifier
statusstringOptionalThe mapped legal entity lifecycle status, the same value as on the single legal entity endpoint. Returned only when the feature is enabled for the organization.
Known values: archived, active, draft, processing, processing_draft, pending_verification, awaiting_review, unknown
updated_atstringOptionalUpdated date
Format: date-time
vat_idJSONOptional
vat_id (anyOf 1)stringAlternativeVAT ID
vat_id (anyOf 2)nullAlternativeVAT ID

Referenced models: List of legal entities — 200 response body — data item address city, country, state, street, zip

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.