Bulk import/export is console-only. For programmatic bulk creation, call
POST /v3/businesses/create/ in a loop.Import businesses from CSV
When to use it
- Migration from another KYB vendor.
- Partner onboarding — load a partner’s customer list.
- Metadata backfill — update tags, tier, or custom fields across many businesses.
Template columns
Download the template from Businesses → Import → Download template:| Column | Required | Description |
|---|---|---|
vendor_data | Yes | Your identifier for the business. Unique per application. |
display_name | No | Human-readable name. |
legal_name | No | Legal company name. Will be overwritten by verified registry data. |
registration_number | No | Company registration. Will be overwritten by verified registry data. |
country_code | No | ISO 3166-1 alpha-3. Triggers dangerous-countries check. |
status | No | ACTIVE, FLAGGED, or BLOCKED. Defaults to ACTIVE. |
tags | No | Comma-separated tags. |
metadata_json | No | Stringified JSON for custom metadata. |
Running the import
Review the preview
Invalid rows are highlighted. Duplicates (existing
vendor_data) are flagged as updates.Start the import
Didit processes rows asynchronously; progress is tracked in Businesses → Import history.
Update vs create
- New
vendor_data→ creates a new Business. - Existing
vendor_data→ updates the Business’s mutable fields and metadata. - Registry-derived fields (
legal_name,registration_number,country_code) are not overwritten by imports after a Business Verification (KYB) session has populated them.
Export businesses to CSV
When to use it
- Compliance audits and regulator requests.
- Data warehouse sync for BI.
- Partner reporting — filtered views of businesses by country, tier, or tag.
Running an export
- Navigate to Businesses → Export.
- Apply filters (status, country, date range, search, tags).
- Choose columns.
- Submit — Didit generates the export asynchronously and emails a signed download link.
Audit trail
All imports and exports are logged with operator, row counts, and timestamps. See audit logs.Next steps
Create business API
Programmatic bulk creation.
Data retention
How long imported data persists.
Audit logs
Review import/export history.