Returns the most recent normalized verification record for a business customer. This is a curated, client-safe view of the latest KYB verification result: it always includes the decision status, the extracted company headline (name, registration number, country, type, incorporation date, registry status), any associated individual identity/document fields, and check summaries (liveness, face match, NFC, proof of address, AML count). Extended detail groups (full business registry details, key people, AML hit details, downloadable documents) are included only when your client has been granted that visibility group.

Only the single newest record is returned, ordered by decision_at (most recent first, records without a decision timestamp last) and then by fetched_at. To retrieve the full chronological list of records for a business, use the /api/v1/kyb/detail/{business_id}/history endpoint.

Authentication & access

• Requires a Bearer token in the Authorization header.
• Requires the kyb.businesses.read permission.
• For client-user tokens, the caller's role must be owner or operations.

Path parameters

• business_id (string, required) - the ID of the business customer to look up. The record is scoped to the authenticated client; records belonging to other clients are not returned.

Visibility groups

The baseline fields are always returned. The following extended groups populate the corresponding response fields only when your client has been granted that group; otherwise the fields are null:

• business_registry_details - registry address, tax number, registered capital, nature of business, contacts, legal entity identifier, risk level, and registry source. Populates the business_registry_details field.
• key_people - UBOs, officers, and directors with ownership detail. Populates the business_key_people field.
• aml_hits - individual AML hit details. Populates the aml_hits field.
• documents - the list of downloadable business document roles. Populates the documents field (download the files via the /api/v1/kyb/detail/{business_id}/documents/{file_role} endpoint).

The KYC-only extended fields (document_number, sof_questionnaire, poa) remain null on KYB records.

Response

200 OK returns the latest verification record. Key fields:

• status - the verification outcome, one of approved, declined, in_review, pending, expired, unknown.
• kind - the verification kind; kyb for this endpoint.
• data_trusted - whether the extracted data is considered trustworthy.
• decision_at - when the decision was reached (may be null).
• fetched_at - when this record was fetched.
• Company fields (all nullable): company_name, registration_number, registration_country, company_type, incorporation_date, registry_status.
• Associated individual identity/document fields (all nullable): first_name, last_name, full_name, date_of_birth, nationality, document_type, document_issuing_country, document_expiry, gender.
• Check summaries (all nullable): liveness_status, liveness_score, face_match_status, face_match_score, nfc_status, poa_status, aml_status, aml_total_hits.
• Granted-only fields (see Visibility groups): business_registry_details, business_key_people, aml_hits, documents.

These check-result fields are populated only when the corresponding check was part of the verification performed; otherwise they are null.

Error responses

Standard 401 (authentication), 403 (insufficient permission or role), and 429 (rate limit) responses apply to every endpoint and are documented in the Error reference.