curl
Businesses
Batch Delete Businesses
Permanently delete businesses — this cannot be undone. For blocking prefer Update Business Status with BLOCKED.
POST
curl
Overview
Deletes one or more Business entities. The business records are removed permanently. Business Verification (KYB) sessions are not covered by this endpoint and survive with their link to the business cleared; delete them with Delete Session. Transactions are not covered either; delete those from the Console.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_datavalues ordidit_internal_idvalues. - Idempotent — deleting an already-deleted business is a no-op.
- Returns only a count of what was deleted, not a per-item report. Values that matched nothing are skipped silently.
- Emits
business.data.updatedwithdeleted_atset. - Records owned by the business entity itself go with it: its tag links, its comment history, and its own device and network records.
- Records produced by a KYB session do NOT: company registry data, uploaded documents, AML hits, beneficial owners and key-people checks all belong to the session and survive until you delete the session itself.
Permissions
Role must grantdelete:businesses. Typically reserved for OWNER and ADMIN.
Related
Authorizations
Body
application/json
Provide vendor_data_list, didit_internal_id_list, or delete_all: true. Precedence when several are sent: delete_all > vendor_data_list > didit_internal_id_list (only the highest-precedence selector is used).
Response
Businesses deleted. Returns the number of rows actually removed.
Number of businesses deleted (excludes vendor_data values that didn't match anything).