Skip to main content
POST
/
v3
/
businesses
/
delete
curl
curl -X POST 'https://verification.didit.me/v3/businesses/delete/' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"vendor_data_list": ["company-123", "company-456"]}'
{
  "deleted": 2
}

​
Overview

Deletes one or more Business entities. Business Verification (KYB) sessions, transactions, and audit logs are retained for the configured data retention period before hard deletion.

​
When to use it

  • Right-to-be-forgotten requests.
  • Clean-up of test businesses during QA.
  • Deprovisioning businesses removed from your own platform.

​
Notes

  • Accepts a list of vendor_data values or didit_internal_id values.
  • Idempotent — deleting an already-deleted business is a no-op.
  • Returns per-row results.
  • Emits business.data.updated with deleted_at set.
  • Linked documents, AML records, and key people associations are deleted alongside.

​
Permissions

Role must grant delete:businesses. Typically reserved for OWNER and ADMIN.

Authorizations

​
x-api-key
string
header
required

Body

application/json

Provide exactly one of vendor_data_list, didit_internal_id_list, or delete_all: true.

​
vendor_data_list
string[]

Your own identifiers to delete. Matching is case-insensitive after normalisation.

​
didit_internal_id_list
string<uuid>[]

Didit's internal UUIDs (didit_internal_id) to delete.

​
delete_all
boolean
default:false

If true, deletes every business in the application. Cannot be combined with the list selectors.

Response

Businesses deleted. Returns the number of rows actually removed.

​
deleted
integer

Number of businesses deleted (excludes vendor_data values that didn't match anything).