Skip to main content
POST
curl
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. Didit waits for the source registry to finish before responding, so fetch_status is resolved in most responses. If a slow registry keeps the profile pending past that wait, the response returns fetch_status: pending with data_resolved: false, and Didit completes the saved check automatically as soon as the provider finishes — re-read the saved verification result instead of repeating the search, since a new search issues new kyb_response_id values.

Authorizations

x-api-key
string
header
required

Body

application/json
kyb_response_id
string
required

Candidate handle from POST /v3/kyb/search/ (kyb_registry.companies[].kyb_response_id). Ephemeral — use it shortly after the search that produced it.

Maximum string length: 255
Example:

"69aeeb95febb0f1704042259"

vendor_data
string

Your identifier for this company; echoed back and stored with the business session.

metadata
object | null

Free-form JSON stored with the business session and echoed back.

save_api_request
boolean
default:true

Must be true (the default). KYB registry selects are always persisted so billing and retrieval can be tracked; false returns 400.

Response

Company retrieved and billed. kyb_registry carries the full profile; check data_resolved — when false the registry was still processing and the stored record completes automatically once it resolves.

request_id
string<uuid>

Id of the business session created for this retrieval. The stored record (visible in the console) keeps updating if the registry resolves after the response.

kyb_registry
object

Full registry company profile.

vendor_data
string | null

Echo of the vendor_data you sent.

metadata
object | null

Echo of the metadata you sent.

created_at
string<date-time>