Skip to main content
POST
/
v3
/
businesses
/
delete
curl --request POST \
  --url https://verification.didit.me/v3/businesses/delete/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "vendor_data_list": [
    "company-123",
    "company-456"
  ]
}
'
{
  "deleted": 123
}

​
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

Response

200 - application/json

Businesses deleted.

​
deleted
integer

Number of businesses deleted