Skip to content

Deel: Retrieve the KYB state of a legal entity — 200 response body — data requirements null item

Retrieve the KYB state of a legal entity: 200 response body, field data / requirements / null / item. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Retrieve the KYB state of a legal entity — 200 response body — data requirements null item

FieldTypePresenceDescription and constraints
$objectRoot
categorystringRequired within parentWhat kind of input satisfies the requirement: a company field, a company document, or an attribute of a declared person.
Known values: FIELD, DOCUMENT, PERSON
is_satisfiedbooleanRequired within parentWhether the current submission already satisfies the requirement.
keystringRequired within parentRequirement key as published by the verification service, e.g. `FORMATION_DATE`, `ARTICLES_OF_INCORPORATION`, `PROOF_OF_AUTHORITY`, `UBO_NAME`, `DIRECTOR_KYC_DOCUMENT`. Person-level keys are prefixed with the role they constrain: `DIRECTOR_`, `CONTROLLING_OFFICER_`, `UBO_` or `SUBMITTER_`.

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.