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.
What is a business profile
A business profile is created automatically when a business session is submitted with avendor_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 |
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:- Download the import template from the console to see the expected column format
- Populate the template with your business data
- Upload the file — Didit creates an import job and processes rows asynchronously
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
Business verification overview
How business verification sessions work end to end.
Console guide
Managing business profiles and sessions in the Business Console.
API reference
Business management API endpoints.