> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Businesses (Vendor Entities)

> Vendor Businesses are Didit's persistent KYB record — registry data, UBOs, officers, AML status, documents, transactions on one profile. Pay-per-call $2.00.

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

| Category               | Fields / objects                                                                                                           |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Identity**           | `vendor_data`, `uuid`, `display_name`, `legal_name`, `registration_number`, `country_code`                                 |
| **Status**             | `ACTIVE`, `FLAGGED`, `BLOCKED`                                                                                             |
| **Session aggregates** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, `features` map                                     |
| **Activity**           | `first_session_at`, `last_session_at`, `last_activity_at`                                                                  |
| **Key people**         | Linked officers, directors, UBOs, beneficial owners (each may link to a User entity for KYC)                               |
| **Documents**          | Certificates of incorporation, articles of association, shareholder registers, POA, financial statements, custom documents |
| **AML**                | Company-level sanctions / PEP / adverse media screening results                                                            |
| **Metadata**           | Arbitrary JSON for your own data                                                                                           |

See the full [Business data model](/entities/businesses/data-model) for field types and edge cases.

## When a Business is created

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="From the console">
    Your team creates the Business from the Businesses page — for example, when manually onboarding a company verified through an offline process.
  </Step>
</Steps>

## What you can do

| Operation                                                      | How                                                 |
| -------------------------------------------------------------- | --------------------------------------------------- |
| [List businesses](/entities/businesses/operations#list)        | `GET /v3/businesses/` with filters                  |
| [Get business](/entities/businesses/operations#get)            | `GET /v3/businesses/{vendor_data}/`                 |
| [Create business](/entities/businesses/operations#create)      | `POST /v3/businesses/create/`                       |
| [Update profile](/entities/businesses/operations#update)       | `PATCH /v3/businesses/{vendor_data}/`               |
| [Change status](/entities/businesses/operations#change-status) | `PATCH /v3/businesses/{vendor_data}/update-status/` |
| [Delete businesses](/entities/businesses/operations#delete)    | `POST /v3/businesses/delete/` (batch)               |
| [Review KYB history](/entities/businesses/kyb-history)         | `GET /v3/sessions?vendor_data=...`                  |
| [Review transactions](/entities/businesses/transactions)       | `GET /v3/transactions/?vendor_data=...`             |
| [Inspect key people](/entities/businesses/key-people)          | Via Business Verification (KYB) session decisions   |
| [Add to blocklist](/entities/businesses/blocklist)             | Console + Lists API                                 |
| [Import / export](/entities/businesses/import-export)          | Console only (CSV)                                  |
| [Manage in console](/entities/businesses/console)              | Full UI walkthrough                                 |

## Business ↔ User relationships

A Business entity is rarely standalone. During [KYB](/business-verification/overview), Didit identifies every officer, director, UBO, and beneficial owner. Each of those people can be linked to a User entity for individual KYC:

```mermaid theme={null}
flowchart LR
    B[Business: biz-acme]
    U1[User: jane-doe<br/>Director]
    U2[User: john-smith<br/>UBO 40%]
    U3[User: alice-chen<br/>UBO 35%]
    U1 --> B
    U2 --> B
    U3 --> B
```

When one of the linked Users has a failed KYC or AML hit, it propagates to the Business's risk profile. See [Key people](/entities/businesses/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

<CardGroup cols={3}>
  <Card title="Data model" icon="database" href="/entities/businesses/data-model">
    Every field, type, and index.
  </Card>

  <Card title="Operations" icon="gear" href="/entities/businesses/operations">
    Create, update, change status, delete.
  </Card>

  <Card title="KYB history" icon="clock-rotate-left" href="/entities/businesses/kyb-history">
    Every Business Verification (KYB) session tied to the business.
  </Card>

  <Card title="Key people" icon="users" href="/entities/businesses/key-people">
    Officers, UBOs, and director linking.
  </Card>

  <Card title="Blocklist" icon="ban" href="/entities/businesses/blocklist">
    Blocking businesses from transactions.
  </Card>

  <Card title="Console" icon="desktop" href="/entities/businesses/console">
    Full Businesses UI walkthrough.
  </Card>
</CardGroup>