Deel: Submit KYB information for a legal entity — request body — body data persons item
Submit KYB information for a legal entity: request body, field body / data / persons / item. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Submit KYB information for a legal entity — request body — body data persons item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
address | Model | Optional | Expand Submit KYB information for a legal entity — request body — body data persons item address Residential address. |
citizenship | string | Optional | Citizenship as an ISO 3166-1 alpha-2 country code. |
date_of_birth | string | Optional | Date of birth, `YYYY-MM-DD`. Format: date |
first_name | string | Required within parent | First name. Maximum length: 255 |
identification_document_type | string | Optional | Type of the identity document supplied in `identity_documents`. One of: PASSPORT, DRIVERS_LICENSE, ID_DOCUMENT |
identity_documents | Model | Optional | Expand Submit KYB information for a legal entity — request body — body data persons item identity documents Identity document sides and selfie for the person, as upload handles. |
job_title | Model | Optional | Expand Submit KYB information for a legal entity — request body — body data persons item job title Role of the person in the company, from the verification service vocabulary; required for controlling officers when the verification service asks for it. |
last_name | string | Required within parent | Last name. Maximum length: 255 |
middle_name | string or null | Optional | Middle name, when any. Maximum length: 255 |
ownership_percentage | number | Optional | Ownership percentage; required for owners when the verification service asks for it. Format: double Maximum: 100 Minimum: 0 |
responsibilities | array | Required within parent | Roles the person holds in the entity. `submitter` marks the person who authorised the submission on the client side. |
responsibilities[] | string | Each item | One of: submitter, controllingOfficer, owner, director |
tax_id | string | Optional | Personal tax identifier. Maximum length: 64 |
Referenced models: Submit KYB information for a legal entity — request body — body data persons item address, Submit KYB information for a legal entity — request body — body data persons item identity documents, Submit KYB information for a legal entity — request body — body data persons item job title