Skip to main content
POST
/
v3
/
kyb
/
select
curl
curl -X POST https://verification.didit.me/v3/kyb/select/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kyb_response_id": "kyb_resp_123",
    "vendor_data": "business-123"
  }'
{
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "kyb_registry": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "registry_status": "<string>",
    "data_resolved": true,
    "company_name": "<string>",
    "registration_number": "<string>",
    "country_code": "<string>",
    "company_type": "<string>",
    "incorporation_date": "2023-12-25",
    "registered_address": "<string>",
    "tax_number": "<string>",
    "is_from_registry": true,
    "fetch_status": "<string>",
    "officers": [
      {}
    ],
    "beneficial_owners": [
      {}
    ],
    "registry_data": {}
  },
  "created_at": "2023-11-07T05:31:56Z",
  "vendor_data": "<string>",
  "metadata": {}
}
Use this endpoint after POST /v3/kyb/search/ returns candidate companies. Selecting a company is billable. It retrieves the full registry profile, stores the request as a Manual Check in the Business Console, and returns a request_id you can use to retrieve the saved business verification result.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
kyb_response_id
string
required

The candidate id returned by POST /v3/kyb/search/.

​
vendor_data
string

Optional caller-controlled business identifier stored on the saved Manual Check.

​
metadata
object
​
save_api_request
boolean
default:true

Must be true; selected KYB registry checks are saved so billing and retrieval can be tracked.

Response

Selected company registry profile. This response is billable.

​
request_id
string<uuid>
required
​
kyb_registry
object
required
​
created_at
string<date-time>
required
​
vendor_data
string | null
​
metadata
object