Deel: Submit KYB information for a legal entity — request body — body data

API reference · Contract 2026-10-27

SDK schema: Submit KYB information for a legal entity — request body — body data

Field	Type	Presence	Description and constraints
$	object	Root
documents	Model	Optional	Expand Submit KYB information for a legal entity — request body — body data documents Company documents as handles from the upload endpoint. Supply the ones the KYB state lists as required.
formation_date	string	Optional	Company formation date, `YYYY-MM-DD`. Format: date
is_declaration_confirmed	boolean	Required within parent	Must be true: the client confirms the information is accurate and complete.
is_person_with_significant_control	boolean	Optional	Declares that the submitter personally holds significant control of the company (an owner, director or controlling officer) — the declared submitter in `persons[]` should hold one of those responsibilities too. An alternative to `proof_of_authority`: when `true`, the verification service waives the Proof of Authority document requirement. Omit or set `false` if the submitter is acting on the company’s behalf without significant control themselves.
is_terms_and_conditions_accepted	boolean	Required within parent	Must be true: the client accepts the verification terms and conditions.
persons	array	Required within parent	Persons of significant control: directors, controlling officers, owners and the client-side submitter.
persons[]	Model	Each item	Expand Submit KYB information for a legal entity — request body — body data persons item
proof_of_authority	Model	Optional	Expand Submit KYB information for a legal entity — request body — body data proof of authority Proof of Authority for the person acting on behalf of the entity. Required when the KYB state lists `PROOF_OF_AUTHORITY` as outstanding, unless `is_person_with_significant_control` is `true`.
transaction_monthly_volume	string	Optional	Expected monthly transaction volume range. One of: LESS_THAN_1K, BETWEEN_1K_AND_10K, BETWEEN_10K_AND_100K, BETWEEN_100K_AND_1M, GREATER_THAN_1M

Referenced models: Submit KYB information for a legal entity — request body — body data documents, Submit KYB information for a legal entity — request body — body data persons item, Submit KYB information for a legal entity — request body — body data proof of authority