> ## 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. From $2.00 per check, priced per country and tier.

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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.