Skip to main content
DELETE
curl (selected transactions)
Delete monitored transactions permanently, by UUID or all at once.

What is deleted

A deleted transaction goes with the records that are only its own: its parties, tags, notes, payment method links, documents and every stored version of their files, rule runs, alerts, provider results, network snapshot and Travel Rule data. Cases, people and companies stay; their link to the deleted transaction is cleared. Draft regulatory reports stop listing the deleted transaction and are rebuilt without it. Deletion is permanent and irreversible.

Select what to delete

Send exactly one selector:
delete_all: true deletes every transaction in the application. There is no confirmation step and no undo.

Blocked by a finalized report

If any selected transaction is listed in a finalized regulatory report, the whole request returns 409 and nothing is deleted:
Delete each report with Delete Report, then repeat this request. If you selected several transactions, remove the blocked ones or delete their reports first.

Authorizations

x-api-key
string
header
required

Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is missing, wrong, revoked or expired; 403 means the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.

Path Parameters

organization_id
string<uuid>
required

Organization UUID.

application_id
string<uuid>
required

Application UUID.

Body

application/json
transaction_uuids
string<uuid>[]
required

Didit transaction UUIDs to delete. Required unless delete_all is true.

Minimum array length: 1
delete_all
enum<boolean>
default:false

Leave out or send false when you select transactions with transaction_uuids.

Available options:
false

Response

Selected transactions deleted.