> This page is for API, version Beta.
> For other versions, use one of these documentation indexes:
> - 2026-01-01 (Stable) (default): https://developer.deel.com/api/stable/llms.txt
> - Beta: https://developer.deel.com/api/beta/llms.txt
> - Deprecated: https://developer.deel.com/api/deprecated/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.deel.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.deel.com/_mcp/server.

# Retrieve the KYB state of a legal entity

GET /legal-entities/{legal_entity_id}/kyb

Returns the Know Your Business (entity verification) state of a legal entity: the verification status, whether the client must act, the outstanding requirements including Proof of Authority, which company documents have been supplied, the declared persons of significant control, when the entity was rejected, and the open enhanced due diligence (EDD) request with its questions while the entity is in EDD. Use it to drive an automated verification flow instead of finishing KYB in the Deel app.

 **Token scopes**: `legal-entity:read`

 **Beta**: this version requires the `X-Beta: true` request header and its contract may change before it is promoted to stable. It is scheduled to become stable on 2027-01-01.

Reference: https://developer.deel.com/api/reference/endpoints/legal-entities/get-legal-entity-kyb-state-v-2026-10-01

## Authentication

- `Authorization` header (bearer token, required) — ## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)
- `Authorization` header (bearer token, required) — Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

## Request

### Path parameters

- `legal_entity_id` (string, required) — Public id of the legal entity. The entity must belong to the authenticated organization; any other id answers 404.

### Headers

- `X-Beta` (enum, required, default: true) — Opts in to the beta version of this endpoint. Must be `true`.
  - Allowed values: `true`

## Response

### 200

The KYB state of the legal entity.

- `data` (LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaData, required)

## Errors

### 400 Bad Request Error

Operation failed.

- `errors` (list of LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaErrorsItems, optional)

### 401 Unauthorized Error

Unauthorized. The request token is missing or invalid. The API gateway rejects an unauthenticated call before it reaches Deel; a call that reaches Deel without a valid session is rejected by the access middleware, whose error item carries a message and no code.

- `errors` (list of LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaErrorsItems, required) — The same error as a list, for partners that parse it.
- `code` (string, optional) — Machine-readable error code.
- `error` (string, optional) — Human-readable explanation of the error.

### 403 Forbidden Error

Forbidden. The token lacks the `legal-entity:read` scope or the actor cannot view entities of this organization.

- `code` (string, required) — Machine-readable error code.
- `error` (string, required) — Human-readable explanation of the error.
- `errors` (list of LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaErrorsItems, required) — The same error as a list, for partners that parse it.

### 404 Not Found Error

Not found. The legal entity does not exist or does not belong to the authenticated organization. The two cases are deliberately indistinguishable.

- `code` (string, required) — Machine-readable error code.
- `error` (string, required) — Human-readable explanation of the error.
- `errors` (list of LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaErrorsItems, required) — The same error as a list, for partners that parse it.

### 500 Internal Server Error

Operation failed.

- `errors` (list of LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaErrorsItems, optional)

## Types

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaData

- `edd` (LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataEdd, required, nullable) — The open enhanced due diligence (EDD) request while the entity is in EDD: Deel needs further answers from the client before it continues the review. Null otherwise, and null while the entity is in EDD when the questions could not be read (retry later).
- `status` (enum, required) — The mapped lifecycle status of the legal entity, the same vocabulary as `status` on `GET /rest/legal-entities/{legal_entity_id}`.
  - Allowed values: `archived`, `active`, `draft`, `processing`, `processing_draft`, `pending_verification`, `awaiting_review`, `unknown`
- `persons` (list of LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataPersonsItems, required, nullable) — Declared persons of significant control: directors, controlling officers, owners and the submitter. Dates of birth, tax ids, addresses and identity documents are never returned; the person requirements in `requirements` show whether they were provided. Null when `is_detail_available` is false.
- `documents` (list of LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataDocumentsItems, required, nullable) — Presence of every company-level document type. Null when `is_detail_available` is false.
- `rejection` (LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataRejection, required, nullable) — Present only when the entity was rejected; null otherwise.
- `approved_at` (string, required, nullable) — When the entity was approved; null otherwise.
- `rejected_at` (string, required, nullable) — When the entity was last rejected; null otherwise.
- `requirements` (list of LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataRequirementsItems, required, nullable) — Everything the verification service currently requires for this entity, with whether each item is already satisfied. Empty when verification is not required. Null when `is_detail_available` is false.
- `submitted_at` (string, required, nullable) — When the verification record was created; null before the first submission.
- `questionnaire` (LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataQuestionnaire, required, nullable) — The industry questionnaire that applies to the legal entity, answered together with the first KYB submission and listed as the `INDUSTRY_QUESTIONNAIRE` requirement. Null when none applies.
- `legal_entity_id` (string, required) — Public id of the legal entity.
- `verification_type` (enum, required, nullable) — Depth of verification the entity is subject to, when known.
  - Allowed values: `NONE`, `LIGHT`, `FULL`
- `is_action_required` (boolean, required) — True while the entity is waiting on the client: `PENDING`, `DRAFT`, or `EDD` (enhanced due diligence — Ops needs something further from the client). False while Deel is reviewing or once the entity is approved, rejected or exempt.
- `is_detail_available` (boolean, required) — False when the verification service could not be read. Every detail block (`requirements`, `documents`, `persons`, `rejection`, `edd`) is then null. Retry later; the status fields are still authoritative.

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaErrorsItems

- `code` (string, optional) — Machine-readable error code
- `message` (string, optional) — Human-readable explanation of the error

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataEdd

The open enhanced due diligence (EDD) request while the entity is in EDD: Deel needs further answers from the client before it continues the review. Null otherwise, and null while the entity is in EDD when the questions could not be read (retry later).

- `id` (string, required) — Public id of the EDD request. Send it as `edd_request_id` when answering.
- `status` (enum, required) — `AWAITING_ANSWERS` until the answers are sent; `ANSWERED` once they are, until the entity is back in review.
  - Allowed values: `AWAITING_ANSWERS`, `ANSWERED`
- `questions` (list of LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataEddQuestionsItems, required) — Every question of the EDD form, in form order.
- `requested_at` (string, required, nullable) — When Deel requested the EDD.
- `is_answerable_over_api` (boolean, required) — False when the form has a required unsupported question. Contact Deel support to clear such a request.

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataPersonsItems

- `id` (string, required, nullable) — Public id of the declared person, when the verification service has assigned one.
- `last_name` (string, required) — Last name as declared.
- `first_name` (string, required) — First name as declared.
- `responsibilities` (list of enum, required) — Roles the person holds in the entity.
  - Allowed values: `submitter`, `controllingOfficer`, `owner`, `director`
- `ownership_percentage` (double, required, nullable) — Declared ownership percentage for owners; null otherwise.

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataDocumentsItems

- `type` (enum, required) — Company-level document type.
  - Allowed values: `PROOF_OF_AUTHORITY`, `ARTICLES_OF_INCORPORATION`, `COMPANY_BANK_STATEMENT`, `LIST_OF_DIRECTORS`, `CERTIFICATE_OF_GOOD_STANDING`, `ULTIMATE_BENEFICIAL_OWNER_FORM`
- `meta_type` (enum, required, nullable) — Kind of Proof of Authority document, when this entry's type is PROOF_OF_AUTHORITY. Null for every other document type.
  - Allowed values: `POWER_OF_ATTORNEY`, `RESOLUTION_OR_MINUTES`, `OTHER`
- `is_provided` (boolean, required) — Whether a file for this document has been submitted. File contents and URLs are never returned.
- `is_required` (boolean, required) — Whether the verification service currently requires this document.

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataRejection

Present only when the entity was rejected; null otherwise.

- `rejected_at` (string, required, nullable) — When the rejection was recorded.

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataRequirementsItems

- `key` (string, required) — Requirement 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_`.
- `category` (enum, required) — What kind of input satisfies the requirement: a company field, a company document, an attribute of a declared person, or the industry questionnaire (`INDUSTRY_QUESTIONNAIRE`, answered in `questionnaire` of the submission and described in the `questionnaire` block of this state).
  - Allowed values: `FIELD`, `DOCUMENT`, `PERSON`, `QUESTIONNAIRE`
- `is_satisfied` (boolean, required) — Whether the current submission already satisfies the requirement.

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataQuestionnaire

The industry questionnaire that applies to the legal entity, answered together with the first KYB submission and listed as the `INDUSTRY_QUESTIONNAIRE` requirement. Null when none applies.

- `answers` (list of LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataQuestionnaireAnswersItems, required, nullable) — The answers the verification service has saved. Null until answers are saved.
- `questions` (list of LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataQuestionnaireQuestionsItems, required) — Every question of the questionnaire, in template order.
- `template_id` (integer, required) — Id of the questionnaire template that applies. Send it as `template_id` when answering.
- `display_name` (string, required) — Display name of the template.

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataEddQuestionsItems

- `key` (string, required) — Key of the question within this EDD request, in form order. Send it as `question_key` when answering.
- `type` (enum, required) — What kind of answer the question takes. `COUNTRY` takes an ISO 3166-1 alpha-2 code (e.g. `US`), `CURRENCY` an ISO 4217 code (e.g. `USD`) and `STATE` a state name (e.g. `California`), each as a string, or a list of strings when the form allows several. `DOCUMENT_UPLOAD` questions are answered with a list of document handles from `POST /rest/legal-entities/{legal_entity_id}/kyb/edd/documents`. `UNSUPPORTED` questions cannot be answered over the API; when one of them is required, `is_answerable_over_api` is false.
  - Allowed values: `TEXT`, `LONG_TEXT`, `NUMBER`, `EMAIL`, `PHONE_NUMBER`, `DATE`, `DATE_RANGE`, `ADDRESS`, `SINGLE_CHOICE`, `MULTIPLE_CHOICE`, `COUNTRY`, `STATE`, `CURRENCY`, `DOCUMENT_UPLOAD`, `UNSUPPORTED`
- `title` (string, required) — The question as the reviewer wrote it.
- `options` (list of string, required, nullable) — For `SINGLE_CHOICE` and `MULTIPLE_CHOICE` questions, the option titles to answer with. Null for every other type.
- `description` (string, required, nullable) — Helper text for the question, when any.
- `is_required` (boolean, required) — Whether the question must currently be answered.
- `repeat_group` (LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataEddQuestionsItemsRepeatGroup, required, nullable) — Set when this question belongs to a repeatable group (e.g. "add another director"); null otherwise.
- `revealed_when` (list of LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataEddQuestionsItemsRevealedWhenItems, required, nullable) — Conditions under which this question applies, met if any one of them does. Null when the question always applies. Only answer it when a condition is met.

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataQuestionnaireAnswersItems

- `value` (LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataQuestionnaireAnswersItemsValue, required) — The saved answer, in the form the question type takes. It is null for a document question: the file is never returned.
- `question_key` (string, required) — The `key` of the question answered.
- `is_document_provided` (boolean, optional) — Present only for a document question that has an uploaded document. It says a document exists; it never gives the file.

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataQuestionnaireQuestionsItems

- `key` (string, required) — Key of the question within the questionnaire. Send it as `question_key` when answering.
- `type` (enum, required) — What kind of answer the question takes. `SINGLE_CHOICE`: the text of one option (a yes/no question has the options `Yes` and `No`). `MULTIPLE_CHOICE`: a list of option texts. `TEXT`: a string. `DOCUMENT_UPLOAD`: a list with exactly one handle from `POST /rest/legal-entities/{legal_entity_id}/kyb/documents`, uploaded with `document_type` `QUESTIONNAIRE_DOCUMENT`.
  - Allowed values: `TEXT`, `LONG_TEXT`, `NUMBER`, `EMAIL`, `PHONE_NUMBER`, `DATE`, `DATE_RANGE`, `ADDRESS`, `SINGLE_CHOICE`, `MULTIPLE_CHOICE`, `COUNTRY`, `STATE`, `CURRENCY`, `DOCUMENT_UPLOAD`, `UNSUPPORTED`
- `title` (string, required) — The question as the reviewer wrote it.
- `options` (list of string, required, nullable) — For `SINGLE_CHOICE` and `MULTIPLE_CHOICE` questions, the option titles to answer with. Null for every other type.
- `description` (string, required, nullable) — Helper text for the question, when any.
- `is_required` (boolean, required) — Whether the question must be answered when it applies. A question with `revealed_when` applies only when one of its conditions is met.
- `revealed_when` (list of LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataQuestionnaireQuestionsItemsRevealedWhenItems, required, nullable) — Conditions under which this question applies, met if any one of them does. Null when the question always applies. Only answer it when a condition is met.

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataEddQuestionsItemsRepeatGroup

Set when this question belongs to a repeatable group (e.g. "add another director"); null otherwise.

- `name` (string, required) — Name of the repeatable group this question belongs to.
- `index` (integer, required) — Zero-based position of this question within its repeat group instance.
- `max_repeats` (integer, required) — Maximum number of instances of this group the form allows.

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataEddQuestionsItemsRevealedWhenItems

- `equals` (string, required) — Option title `question` must be answered with for this question to apply.
- `question` (string, required) — Key of the question whose answer gates this one.

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataQuestionnaireAnswersItemsValue

The saved answer, in the form the question type takes. It is null for a document question: the file is never returned.

- string
- list of string

### LegalEntitiesLegalEntityIdKybGetResponsesContentApplicationJsonSchemaDataQuestionnaireQuestionsItemsRevealedWhenItems

- `equals` (string, required) — Option title `question` must be answered with for this question to apply.
- `question` (string, required) — Key of the question whose answer gates this one.

## Examples

### Enhanced due diligence (EDD) requested

**Response**

```json
{
  "data": {
    "edd": {
      "id": "0b8f3e0a-6c2d-4f0e-9d3b-2a1f5c7e9b41",
      "status": "AWAITING_ANSWERS",
      "questions": [
        {
          "key": "q1",
          "type": "SINGLE_CHOICE",
          "title": "Does the company receive funds from outside its country of incorporation?",
          "options": [
            "Yes",
            "No"
          ],
          "description": null,
          "is_required": true,
          "repeat_group": null,
          "revealed_when": null
        },
        {
          "key": "q2",
          "type": "DOCUMENT_UPLOAD",
          "title": "Upload a contract with your largest foreign customer.",
          "options": null,
          "description": "PDF, JPEG or PNG.",
          "is_required": true,
          "repeat_group": null,
          "revealed_when": [
            {
              "equals": "Yes",
              "question": "q1"
            }
          ]
        },
        {
          "key": "q3",
          "type": "TEXT",
          "title": "Describe the company's main business activity.",
          "options": null,
          "description": null,
          "is_required": true,
          "repeat_group": null,
          "revealed_when": null
        },
        {
          "key": "q4",
          "type": "NUMBER",
          "title": "What is the expected yearly turnover in EUR?",
          "options": null,
          "description": null,
          "is_required": true,
          "repeat_group": null,
          "revealed_when": null
        },
        {
          "key": "q5",
          "type": "DATE_RANGE",
          "title": "Which period do the financial statements cover?",
          "options": null,
          "description": "Optional.",
          "is_required": false,
          "repeat_group": null,
          "revealed_when": null
        },
        {
          "key": "q6",
          "type": "ADDRESS",
          "title": "What is the registered address of your largest foreign customer?",
          "options": null,
          "description": null,
          "is_required": true,
          "repeat_group": null,
          "revealed_when": [
            {
              "equals": "Yes",
              "question": "q1"
            }
          ]
        },
        {
          "key": "q7",
          "type": "MULTIPLE_CHOICE",
          "title": "Which sources fund the account?",
          "options": [
            "Revenue from customers",
            "Investment",
            "Loan"
          ],
          "description": null,
          "is_required": true,
          "repeat_group": null,
          "revealed_when": null
        }
      ],
      "requested_at": "2026-09-05T09:00:00Z",
      "is_answerable_over_api": true
    },
    "status": "pending_verification",
    "persons": [
      {
        "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
        "last_name": "Hopper",
        "first_name": "Grace",
        "responsibilities": [
          "submitter"
        ],
        "ownership_percentage": null
      },
      {
        "id": "c51e53d2-8a2f-4944-890b-f605a3ab247e",
        "last_name": "Lovelace",
        "first_name": "Ada",
        "responsibilities": [
          "owner",
          "director"
        ],
        "ownership_percentage": 60
      },
      {
        "id": "d62f64e3-9b3a-4a55-9a1c-0716b4bc358f",
        "last_name": "Babbage",
        "first_name": "Charles",
        "responsibilities": [
          "owner"
        ],
        "ownership_percentage": 40
      }
    ],
    "documents": [
      {
        "type": "PROOF_OF_AUTHORITY",
        "meta_type": "POWER_OF_ATTORNEY",
        "is_provided": true,
        "is_required": true
      },
      {
        "type": "ARTICLES_OF_INCORPORATION",
        "meta_type": null,
        "is_provided": true,
        "is_required": true
      },
      {
        "type": "COMPANY_BANK_STATEMENT",
        "meta_type": null,
        "is_provided": true,
        "is_required": false
      },
      {
        "type": "CERTIFICATE_OF_GOOD_STANDING",
        "meta_type": null,
        "is_provided": true,
        "is_required": false
      },
      {
        "type": "ULTIMATE_BENEFICIAL_OWNER_FORM",
        "meta_type": null,
        "is_provided": true,
        "is_required": false
      }
    ],
    "rejection": null,
    "approved_at": null,
    "rejected_at": null,
    "requirements": [
      {
        "key": "ARTICLES_OF_INCORPORATION",
        "category": "DOCUMENT",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_ADDRESS",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_DOB",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_NAME",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_SELFIE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "FORMATION_DATE",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "IDENTIFICATION_DOCUMENT_TYPE",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "PROOF_OF_AUTHORITY",
        "category": "DOCUMENT",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_ADDRESS",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_DOB",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_NAME",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_SELFIE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "TERMS_AND_CONDITIONS",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "TRANSACTION_MONTHLY_VOLUME",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "UBO_ADDRESS",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_DOB",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_NAME",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_OWNERSHIP_PERCENTAGE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_SELFIE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_TAX_ID",
        "category": "PERSON",
        "is_satisfied": true
      }
    ],
    "submitted_at": "2026-09-01T10:30:00Z",
    "questionnaire": null,
    "legal_entity_id": "5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b",
    "verification_type": "FULL",
    "is_action_required": true,
    "is_detail_available": true
  }
}
```

**SDK Code**

```python Enhanced due diligence (EDD) requested
import requests

url = "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb"

headers = {
    "X-Beta": "true",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript Enhanced due diligence (EDD) requested
const url = 'https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb';
const options = {method: 'GET', headers: {'X-Beta': 'true', Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Enhanced due diligence (EDD) requested
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Beta", "true")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Enhanced due diligence (EDD) requested
require 'uri'
require 'net/http'

url = URI("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Beta"] = 'true'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Enhanced due diligence (EDD) requested
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")
  .header("X-Beta", "true")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Enhanced due diligence (EDD) requested
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'X-Beta' => 'true',
  ],
]);

echo $response->getBody();
```

```csharp Enhanced due diligence (EDD) requested
using RestSharp;

var client = new RestClient("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb");
var request = new RestRequest(Method.GET);
request.AddHeader("X-Beta", "true");
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Enhanced due diligence (EDD) requested
import Foundation

let headers = [
  "X-Beta": "true",
  "Authorization": "Bearer <token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

### Approved

**Response**

```json
{
  "data": {
    "edd": null,
    "status": "active",
    "persons": [
      {
        "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
        "last_name": "Hopper",
        "first_name": "Grace",
        "responsibilities": [
          "submitter"
        ],
        "ownership_percentage": null
      },
      {
        "id": "c51e53d2-8a2f-4944-890b-f605a3ab247e",
        "last_name": "Lovelace",
        "first_name": "Ada",
        "responsibilities": [
          "owner",
          "director"
        ],
        "ownership_percentage": 60
      },
      {
        "id": "d62f64e3-9b3a-4a55-9a1c-0716b4bc358f",
        "last_name": "Babbage",
        "first_name": "Charles",
        "responsibilities": [
          "owner"
        ],
        "ownership_percentage": 40
      }
    ],
    "documents": [
      {
        "type": "PROOF_OF_AUTHORITY",
        "meta_type": "POWER_OF_ATTORNEY",
        "is_provided": true,
        "is_required": true
      },
      {
        "type": "ARTICLES_OF_INCORPORATION",
        "meta_type": null,
        "is_provided": true,
        "is_required": true
      },
      {
        "type": "COMPANY_BANK_STATEMENT",
        "meta_type": null,
        "is_provided": true,
        "is_required": false
      },
      {
        "type": "CERTIFICATE_OF_GOOD_STANDING",
        "meta_type": null,
        "is_provided": true,
        "is_required": false
      },
      {
        "type": "ULTIMATE_BENEFICIAL_OWNER_FORM",
        "meta_type": null,
        "is_provided": true,
        "is_required": false
      }
    ],
    "rejection": null,
    "approved_at": "2026-09-12T15:30:00Z",
    "rejected_at": null,
    "requirements": [
      {
        "key": "ARTICLES_OF_INCORPORATION",
        "category": "DOCUMENT",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_ADDRESS",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_DOB",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_NAME",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_SELFIE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "FORMATION_DATE",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "IDENTIFICATION_DOCUMENT_TYPE",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "PROOF_OF_AUTHORITY",
        "category": "DOCUMENT",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_ADDRESS",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_DOB",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_NAME",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_SELFIE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "TERMS_AND_CONDITIONS",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "TRANSACTION_MONTHLY_VOLUME",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "UBO_ADDRESS",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_DOB",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_NAME",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_OWNERSHIP_PERCENTAGE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_SELFIE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_TAX_ID",
        "category": "PERSON",
        "is_satisfied": true
      }
    ],
    "submitted_at": "2026-09-01T10:30:00Z",
    "questionnaire": null,
    "legal_entity_id": "5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b",
    "verification_type": "FULL",
    "is_action_required": false,
    "is_detail_available": true
  }
}
```

**SDK Code**

```python Approved
import requests

url = "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb"

headers = {
    "X-Beta": "true",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript Approved
const url = 'https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb';
const options = {method: 'GET', headers: {'X-Beta': 'true', Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Approved
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Beta", "true")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Approved
require 'uri'
require 'net/http'

url = URI("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Beta"] = 'true'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Approved
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")
  .header("X-Beta", "true")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Approved
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'X-Beta' => 'true',
  ],
]);

echo $response->getBody();
```

```csharp Approved
using RestSharp;

var client = new RestClient("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb");
var request = new RestRequest(Method.GET);
request.AddHeader("X-Beta", "true");
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Approved
import Foundation

let headers = [
  "X-Beta": "true",
  "Authorization": "Bearer <token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

### Rejected

**Response**

```json
{
  "data": {
    "edd": null,
    "status": "pending_verification",
    "persons": [
      {
        "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
        "last_name": "Hopper",
        "first_name": "Grace",
        "responsibilities": [
          "submitter"
        ],
        "ownership_percentage": null
      },
      {
        "id": "c51e53d2-8a2f-4944-890b-f605a3ab247e",
        "last_name": "Lovelace",
        "first_name": "Ada",
        "responsibilities": [
          "owner",
          "director"
        ],
        "ownership_percentage": 60
      },
      {
        "id": "d62f64e3-9b3a-4a55-9a1c-0716b4bc358f",
        "last_name": "Babbage",
        "first_name": "Charles",
        "responsibilities": [
          "owner"
        ],
        "ownership_percentage": 40
      }
    ],
    "documents": [
      {
        "type": "PROOF_OF_AUTHORITY",
        "meta_type": "POWER_OF_ATTORNEY",
        "is_provided": true,
        "is_required": true
      },
      {
        "type": "ARTICLES_OF_INCORPORATION",
        "meta_type": null,
        "is_provided": true,
        "is_required": true
      },
      {
        "type": "COMPANY_BANK_STATEMENT",
        "meta_type": null,
        "is_provided": true,
        "is_required": false
      },
      {
        "type": "CERTIFICATE_OF_GOOD_STANDING",
        "meta_type": null,
        "is_provided": true,
        "is_required": false
      },
      {
        "type": "ULTIMATE_BENEFICIAL_OWNER_FORM",
        "meta_type": null,
        "is_provided": true,
        "is_required": false
      }
    ],
    "rejection": {
      "rejected_at": "2026-09-10T09:00:00Z"
    },
    "approved_at": null,
    "rejected_at": "2026-09-10T09:00:00Z",
    "requirements": [
      {
        "key": "ARTICLES_OF_INCORPORATION",
        "category": "DOCUMENT",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_ADDRESS",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_DOB",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_NAME",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_SELFIE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "FORMATION_DATE",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "IDENTIFICATION_DOCUMENT_TYPE",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "PROOF_OF_AUTHORITY",
        "category": "DOCUMENT",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_ADDRESS",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_DOB",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_NAME",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_SELFIE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "TERMS_AND_CONDITIONS",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "TRANSACTION_MONTHLY_VOLUME",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "UBO_ADDRESS",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_DOB",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "UBO_NAME",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_OWNERSHIP_PERCENTAGE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_SELFIE",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "UBO_TAX_ID",
        "category": "PERSON",
        "is_satisfied": true
      }
    ],
    "submitted_at": "2026-09-01T10:30:00Z",
    "questionnaire": null,
    "legal_entity_id": "5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b",
    "verification_type": "FULL",
    "is_action_required": false,
    "is_detail_available": true
  }
}
```

**SDK Code**

```python Rejected
import requests

url = "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb"

headers = {
    "X-Beta": "true",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript Rejected
const url = 'https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb';
const options = {method: 'GET', headers: {'X-Beta': 'true', Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Rejected
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Beta", "true")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Rejected
require 'uri'
require 'net/http'

url = URI("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Beta"] = 'true'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Rejected
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")
  .header("X-Beta", "true")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Rejected
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'X-Beta' => 'true',
  ],
]);

echo $response->getBody();
```

```csharp Rejected
using RestSharp;

var client = new RestClient("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb");
var request = new RestRequest(Method.GET);
request.AddHeader("X-Beta", "true");
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Rejected
import Foundation

let headers = [
  "X-Beta": "true",
  "Authorization": "Bearer <token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

### Submitted, waiting for review

**Response**

```json
{
  "data": {
    "edd": null,
    "status": "awaiting_review",
    "persons": [
      {
        "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
        "last_name": "Hopper",
        "first_name": "Grace",
        "responsibilities": [
          "submitter"
        ],
        "ownership_percentage": null
      },
      {
        "id": "c51e53d2-8a2f-4944-890b-f605a3ab247e",
        "last_name": "Lovelace",
        "first_name": "Ada",
        "responsibilities": [
          "owner",
          "director"
        ],
        "ownership_percentage": 60
      },
      {
        "id": "d62f64e3-9b3a-4a55-9a1c-0716b4bc358f",
        "last_name": "Babbage",
        "first_name": "Charles",
        "responsibilities": [
          "owner"
        ],
        "ownership_percentage": 40
      }
    ],
    "documents": [
      {
        "type": "PROOF_OF_AUTHORITY",
        "meta_type": "POWER_OF_ATTORNEY",
        "is_provided": true,
        "is_required": true
      },
      {
        "type": "ARTICLES_OF_INCORPORATION",
        "meta_type": null,
        "is_provided": true,
        "is_required": true
      },
      {
        "type": "COMPANY_BANK_STATEMENT",
        "meta_type": null,
        "is_provided": true,
        "is_required": false
      },
      {
        "type": "CERTIFICATE_OF_GOOD_STANDING",
        "meta_type": null,
        "is_provided": true,
        "is_required": false
      },
      {
        "type": "ULTIMATE_BENEFICIAL_OWNER_FORM",
        "meta_type": null,
        "is_provided": true,
        "is_required": false
      }
    ],
    "rejection": null,
    "approved_at": null,
    "rejected_at": null,
    "requirements": [
      {
        "key": "ARTICLES_OF_INCORPORATION",
        "category": "DOCUMENT",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_ADDRESS",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_DOB",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_NAME",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "DIRECTOR_SELFIE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "FORMATION_DATE",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "IDENTIFICATION_DOCUMENT_TYPE",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "PROOF_OF_AUTHORITY",
        "category": "DOCUMENT",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_ADDRESS",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_DOB",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_NAME",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "SUBMITTER_SELFIE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "TERMS_AND_CONDITIONS",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "TRANSACTION_MONTHLY_VOLUME",
        "category": "FIELD",
        "is_satisfied": true
      },
      {
        "key": "UBO_ADDRESS",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_DOB",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_NAME",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_OWNERSHIP_PERCENTAGE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_SELFIE",
        "category": "PERSON",
        "is_satisfied": true
      },
      {
        "key": "UBO_TAX_ID",
        "category": "PERSON",
        "is_satisfied": true
      }
    ],
    "submitted_at": "2026-09-01T10:30:00Z",
    "questionnaire": null,
    "legal_entity_id": "5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b",
    "verification_type": "FULL",
    "is_action_required": false,
    "is_detail_available": true
  }
}
```

**SDK Code**

```python Submitted, waiting for review
import requests

url = "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb"

headers = {
    "X-Beta": "true",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript Submitted, waiting for review
const url = 'https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb';
const options = {method: 'GET', headers: {'X-Beta': 'true', Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Submitted, waiting for review
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Beta", "true")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Submitted, waiting for review
require 'uri'
require 'net/http'

url = URI("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Beta"] = 'true'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Submitted, waiting for review
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")
  .header("X-Beta", "true")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Submitted, waiting for review
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'X-Beta' => 'true',
  ],
]);

echo $response->getBody();
```

```csharp Submitted, waiting for review
using RestSharp;

var client = new RestClient("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb");
var request = new RestRequest(Method.GET);
request.AddHeader("X-Beta", "true");
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Submitted, waiting for review
import Foundation

let headers = [
  "X-Beta": "true",
  "Authorization": "Bearer <token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

### Not submitted yet

**Response**

```json
{
  "data": {
    "edd": null,
    "status": "pending_verification",
    "persons": [],
    "documents": [
      {
        "type": "PROOF_OF_AUTHORITY",
        "meta_type": null,
        "is_provided": false,
        "is_required": true
      },
      {
        "type": "ARTICLES_OF_INCORPORATION",
        "meta_type": null,
        "is_provided": false,
        "is_required": true
      },
      {
        "type": "COMPANY_BANK_STATEMENT",
        "meta_type": null,
        "is_provided": false,
        "is_required": false
      },
      {
        "type": "CERTIFICATE_OF_GOOD_STANDING",
        "meta_type": null,
        "is_provided": false,
        "is_required": false
      },
      {
        "type": "ULTIMATE_BENEFICIAL_OWNER_FORM",
        "meta_type": null,
        "is_provided": false,
        "is_required": false
      }
    ],
    "rejection": null,
    "approved_at": null,
    "rejected_at": null,
    "requirements": [
      {
        "key": "ARTICLES_OF_INCORPORATION",
        "category": "DOCUMENT",
        "is_satisfied": false
      },
      {
        "key": "DIRECTOR_ADDRESS",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "DIRECTOR_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "DIRECTOR_DOB",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "DIRECTOR_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "DIRECTOR_NAME",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "DIRECTOR_SELFIE",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "FORMATION_DATE",
        "category": "FIELD",
        "is_satisfied": false
      },
      {
        "key": "IDENTIFICATION_DOCUMENT_TYPE",
        "category": "FIELD",
        "is_satisfied": false
      },
      {
        "key": "PROOF_OF_AUTHORITY",
        "category": "DOCUMENT",
        "is_satisfied": false
      },
      {
        "key": "SUBMITTER_ADDRESS",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "SUBMITTER_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "SUBMITTER_DOB",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "SUBMITTER_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "SUBMITTER_NAME",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "SUBMITTER_SELFIE",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "TERMS_AND_CONDITIONS",
        "category": "FIELD",
        "is_satisfied": false
      },
      {
        "key": "TRANSACTION_MONTHLY_VOLUME",
        "category": "FIELD",
        "is_satisfied": false
      },
      {
        "key": "UBO_ADDRESS",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "UBO_CITIZENSHIP",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "UBO_DOB",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "UBO_KYC_DOCUMENT",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "UBO_NAME",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "UBO_OWNERSHIP_PERCENTAGE",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "UBO_SELFIE",
        "category": "PERSON",
        "is_satisfied": false
      },
      {
        "key": "UBO_TAX_ID",
        "category": "PERSON",
        "is_satisfied": false
      }
    ],
    "submitted_at": null,
    "questionnaire": null,
    "legal_entity_id": "5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b",
    "verification_type": "FULL",
    "is_action_required": true,
    "is_detail_available": true
  }
}
```

**SDK Code**

```python Not submitted yet
import requests

url = "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb"

headers = {
    "X-Beta": "true",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript Not submitted yet
const url = 'https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb';
const options = {method: 'GET', headers: {'X-Beta': 'true', Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Not submitted yet
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Beta", "true")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Not submitted yet
require 'uri'
require 'net/http'

url = URI("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Beta"] = 'true'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Not submitted yet
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")
  .header("X-Beta", "true")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Not submitted yet
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'X-Beta' => 'true',
  ],
]);

echo $response->getBody();
```

```csharp Not submitted yet
using RestSharp;

var client = new RestClient("https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb");
var request = new RestRequest(Method.GET);
request.AddHeader("X-Beta", "true");
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Not submitted yet
import Foundation

let headers = [
  "X-Beta": "true",
  "Authorization": "Bearer <token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.example.com/legal-entities/5f4a2c0e-6f1c-4a52-9c4e-1c8f1d2e3a4b/kyb")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```