> ## 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.

# Business Profiles

> Track verified companies across sessions with auto-created profiles, status management, tags, bulk ops, and CSV import/export. Pay-per-call $2.00 KYB.

Didit automatically creates a business profile for each company you verify, aggregating verification data and session history into a single entity. Business profiles provide a unified view of each company across all their verification sessions.

<Note>
  Business profiles are the KYB-specific surface of the more general **Business entity** model. For the full entity model — operations, key-people linking to Users, blocklist mechanics, import/export — see [Businesses overview](/entities/businesses/overview).
</Note>

## What is a business profile

A business profile is created automatically when a [business session](/business-verification/overview) is submitted with a `vendor_data` identifier. If a profile with that identifier already exists, the new session is linked to it.

| Field                   | Description                                                    |
| ----------------------- | -------------------------------------------------------------- |
| **Vendor data**         | Your unique identifier for this business (e.g., `company-123`) |
| **Display name**        | Display name shown in the console                              |
| **Legal name**          | Official legal name from registry or manual entry              |
| **Registration number** | Company registration or incorporation number                   |
| **Country**             | Country of incorporation (ISO 3166-1 alpha-2)                  |

## Profile statuses

| Status    | Description                                                    |
| --------- | -------------------------------------------------------------- |
| `ACTIVE`  | Business is in good standing — no issues detected              |
| `FLAGGED` | Business requires attention — review results or pending checks |
| `BLOCKED` | Business has been blocked from further activity                |

Statuses can be changed manually from the console, in bulk, or automatically based on verification results.

## Session metrics

Each profile tracks verification metrics across all linked sessions:

| Metric             | Description                                                            |
| ------------------ | ---------------------------------------------------------------------- |
| **Total sessions** | Number of verification sessions for this business                      |
| **Approved**       | Sessions that passed all checks                                        |
| **Declined**       | Sessions that failed one or more critical checks                       |
| **In review**      | Sessions awaiting analyst review                                       |
| **Last session**   | Timestamp of the most recent verification                              |
| **First session**  | Timestamp of the earliest verification                                 |
| **Last activity**  | Timestamp of any recent activity (status change, session update, etc.) |

## Tags

Apply tags to business profiles for categorisation and filtering. Tags are application-defined — create custom tags that fit your workflow (e.g., `high-risk`, `vip-client`, `re-verification-needed`).

## Bulk operations

Manage multiple business profiles at once:

| Operation              | Description                                                                         |
| ---------------------- | ----------------------------------------------------------------------------------- |
| **Bulk status update** | Change the status of selected profiles (or all profiles matching current filters)   |
| **CSV export**         | Export profile data to CSV with configurable column selection                       |
| **CSV import**         | Import business profiles from a CSV file to pre-create profiles before verification |
| **Bulk delete**        | Remove selected profiles and their associated data                                  |

### CSV import

To import business profiles in bulk:

1. Download the **import template** from the console to see the expected column format
2. Populate the template with your business data
3. Upload the file — Didit creates an import job and processes rows asynchronously

After completion, review the import summary for created, updated, and failed row counts. Failed rows include specific error details.

## Reviews and comments

Add internal review notes to any business profile. Comments are visible to all team members with access and form part of the audit trail:

* Add notes with free-text content
* Mention team members by email to notify them
* View the full comment history with author and timestamp

## Next steps

<CardGroup cols={2}>
  <Card title="Business verification overview" icon="building" href="/business-verification/overview">
    How business verification sessions work end to end.
  </Card>

  <Card title="Console guide" icon="gauge" href="/business-verification/console">
    Managing business profiles and sessions in the Business Console.
  </Card>

  <Card title="API reference" icon="code" href="/management-api/businesses/list">
    Business management API endpoints.
  </Card>
</CardGroup>