Deel: Retrieve the KYB state of a legal entity — 200 response body — data persons null item
Retrieve the KYB state of a legal entity: 200 response body, field data / persons / 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 persons null item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
first_name | string | Required within parent | First name as declared. |
id | JSON | Required within parent | |
id (anyOf 1) | string | Alternative | Public id of the declared person, when the verification service has assigned one. Format: uuid |
id (anyOf 2) | null | Alternative | Public id of the declared person, when the verification service has assigned one. Format: uuid |
last_name | string | Required within parent | Last name as declared. |
ownership_percentage | JSON | Required within parent | |
ownership_percentage (anyOf 1) | JSON | Alternative | |
ownership_percentage (anyOf 1) (anyOf 1) | number | Alternative | Declared ownership percentage for owners; null otherwise. Format: double |
ownership_percentage (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
ownership_percentage (anyOf 2) | null | Alternative | Declared ownership percentage for owners; null otherwise. Format: double |
responsibilities | array | Required within parent | Roles the person holds in the entity. |
responsibilities[] | string | Each item | Known values: submitter, controllingOfficer, owner, director |