Skip to main content
A Business entity represents a legal entity (company, LLC, fund, foundation, sole proprietorship, trust) across every KYB verification, transaction, and compliance interaction it has with your platform on Didit. Like User entities, Business entities are keyed by vendor_data and aggregate all linked sessions and transactions into a single profile.

​
What lives on a Business

See the full Business data model for field types and edge cases.

​
When a Business is created

1

Automatically — from a Business Verification (KYB) session

When you create a Business Verification (KYB) session with a vendor_data Didit has never seen, a Business entity is created in ACTIVE status and linked to that session.
2

Explicitly — via POST /v3/businesses/create/

Pre-create the Business before running any Business Verification (KYB) session. Useful for seeding metadata or bulk-onboarding companies.
3

From the console

Your team creates the Business from the Businesses page — for example, when manually onboarding a company verified through an offline process.

​
What you can do

​
Business ↔ User relationships

A Business entity is rarely standalone. During KYB, Didit identifies every officer, director, UBO, and beneficial owner. Each of those people can be linked to a User entity for individual KYC: When one of the linked Users has a failed KYC or AML hit, it propagates to the Business’s risk profile. See Key people for the linkage pattern.

​
Business vs business session

A business session is one KYB verification event. A Business entity is the durable profile that aggregates all sessions. A single Business can have many Business Verification (KYB) sessions — initial verification, resubmissions, periodic re-KYB. The Business’s features map reflects the latest state across all sessions.

​
Next steps

Data model

Every field, type, and index.

Operations

Create, update, change status, delete.

KYB history

Every Business Verification (KYB) session tied to the business.

Key people

Officers, UBOs, and director linking.

Blocklist

Blocking businesses from transactions.

Console

Full Businesses UI walkthrough.