Retrieve a Business entity by vendor_data. Returns the full data model including registry-derived identity, status, aggregated KYB counters, and the features map.
vendor_data.
features map gives you the latest status of every KYB feature at a glance.vendor_data in the URL is case-sensitive.404 if no business with that vendor_data exists.session_count, approved_count, declined_count, in_review_count) update in real time as Business Verification (KYB) sessions complete.legal_name, registration_number, country_code) reflect the latest approved Business Verification (KYB) session.read:businesses.
Your unique identifier for the business (the vendor_data you passed when creating sessions).
Full business detail including metadata, comments/activity log, and all session data.
Full business detail. Extends BusinessListItem with metadata and comments.
Didit's stable internal UUID for this business.
Your unique identifier for this business (passed when creating sessions). This can be null when no vendor identifier was supplied.
Custom display name set by you
Official legal name from registry or manual entry
Company registration or incorporation number
Country of incorporation (ISO 3166-1 alpha-2, e.g. GB, US).
ISO 3166-2 subdivision code (e.g. CA, NY for US states).
Best available name: display_name if set, otherwise legal_name
Current status of this business
Active, Flagged, Blocked Total number of verification sessions for this business
Number of approved sessions
Number of declined sessions
Number of sessions in review
Map of feature name to latest status, e.g. {"KYB_REGISTRY": "Approved", "KYB_AML": "Approved"}
Same as features but as an array of {feature, status} objects
Timestamp of the most recent session
Timestamp of the first session
Timestamp of the most recent activity (status change, session update, etc.)
Tags assigned to this business
Custom metadata JSON you attached to this business
Activity log and comments for this business