> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Transaktionen löschen: Batch-API > Didit löscht überwachte Transaktionen dauerhaft per UUID oder alle Transaktionen der Anwendung. Ein finalisierter Bericht blockiert die Löschung. Batch-Löschung von Transaktionen: API-Prompt Prompt in die Zwischenablage kopieren \

\`Delete monitored transactions through the Management API.

Endpoint:
DELETE https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/transactions/delete/

Authentication:
Use the x-api-key header with my Didit API key. The key must carry write:transactions.

Request body — provide one selector:
\{"transaction_uuids": ["abcdef12-3456-7890-abcd-ef1234567890"]}
or
\{"delete_all": true}

Example call:
curl -X DELETE "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/transactions/delete/" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"transaction_uuids": ["abcdef12-3456-7890-abcd-ef1234567890"]}'

Response 204: the selected transactions are deleted.

What is deleted with each transaction:
\- Its parties, tags, notes, payment method links, documents and every stored version of their files.
\- Its 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 it and are rebuilt without it. Deletion is permanent and cannot be undone.

Failure modes:
\- 400 - no selector supplied: {"transaction_uuids": ["This field is required unless delete_all is true."]}.
\- 409 - at least one selected transaction is listed in a finalized regulatory report. Nothing is deleted. The body has code: in_filed_report and transactions[] with uuid, transaction_id and reports[].
\- 403 - the key cannot delete transactions (requires write:transactions).

After deletion:
Delete the reports named in the 409 response, then repeat this request. See Delete Report.

WARNING — delete_all: true: deletes every transaction in the application with no confirmation and no undo.

For the full integration shape, see /integration/integration-prompt.`

\
Einfügen in Überwachte Transaktionen dauerhaft löschen, einzeln über die UUID oder alle auf einmal.## Was gelöscht wirdEine gelöschte Transaktion wird samt den Datensätzen entfernt, die ausschließlich zu ihr gehören: ihre Beteiligten, Tags, Notizen, Verknüpfungen mit Zahlungsmethoden, Dokumente und alle gespeicherten Versionen von deren Dateien, Regelausführungen, Alerts, Ergebnisse der Anbieter, Netzwerk-Snapshot und Travel-Rule-Daten.Fälle, Personen und Unternehmen bleiben erhalten; ihre Verknüpfung mit der gelöschten Transaktion wird aufgehoben. Entwürfe regulatorischer Berichte listen die gelöschte Transaktion nicht mehr auf und werden ohne sie neu erstellt. Die Löschung ist dauerhaft und nicht rückgängig zu machen.## Auswahl der zu löschenden TransaktionenSenden Sie genau eine Auswahloption:| Feld | Typ | Beschreibung | | - | - | - | | `transaction_uuids` | UUID\[] | Didit-Transaktions-UUIDs, die gelöscht werden sollen. Erforderlich, sofern `delete_all` nicht `true` ist. | | `delete_all` | boolean | Löscht jede Transaktion in der Anwendung. `transaction_uuids` wird ignoriert. |> [!WARNING] > > `delete_all: true` löscht jede Transaktion in der Anwendung. Es gibt keinen Bestätigungsschritt und keine Möglichkeit, dies rückgängig zu machen.## Blockiert durch einen finalisierten BerichtIst eine der ausgewählten Transaktionen in einem finalisierten regulatorischen Bericht aufgeführt, gibt die gesamte Anfrage `409` zurück, und es wird nichts gelöscht:```json theme={null} { "detail": "Transactions included in a filed regulatory report cannot be deleted.", "code": "in_filed_report", "transactions": [ { "uuid": "abcdef12-3456-7890-abcd-ef1234567890", "transaction_id": "your-txn-2026-05-17-001", "reports": [ { "uuid": "5ec00000-0000-4000-8000-000000000007", "report_number": "SAR-0001", "report_type": "SAR", "case_uuid": "c1a5e000-0000-4000-8000-000000000001" } ] } ] } ```Löschen Sie jeden Bericht mit [Bericht löschen](https://docs.didit.me/de/management-api/regulatory-reports/delete.md) und wiederholen Sie dann diese Anfrage. Haben Sie mehrere Transaktionen ausgewählt, entfernen Sie die blockierten oder löschen Sie zuerst deren Berichte.## Verwandte Inhalte- [Transaktionen auflisten](https://docs.didit.me/de/management-api/transactions/list.md) - [Transaktion abrufen](https://docs.didit.me/de/management-api/transactions/get.md) - [Bericht löschen](https://docs.didit.me/de/management-api/regulatory-reports/delete.md) ## OpenAPI ````yaml de/openapi-25.json DELETE /v3/organization/{organization_id}/application/{application_id}/transactions/delete/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/transactions/delete/: delete: tags: - Transactions summary: Transaktionen im Batch löschen description: >- Eine oder mehrere Transaktionen dauerhaft löschen. Wählen Sie diese über `transaction_uuids` aus oder löschen Sie jede Transaktion in der Anwendung mit `delete_all: true`. Eine gelöschte Transaktion wird zusammen mit den Datensätzen entfernt, die ausschließlich zu ihr gehören: ihre Parteien, Tags, Notizen, Zahlungsmethoden-Verknüpfungen, Dokumente und jede gespeicherte Version ihrer Dateien, Regelausführungen, Alerts, Anbieterergebnisse, Netzwerk-Snapshot und Travel-Rule-Daten. Fälle, Personen und Unternehmen bleiben erhalten; ihre Verknüpfung mit der gelöschten Transaktion wird entfernt. Entwürfe behördlicher Berichte führen sie nicht mehr auf und werden ohne sie neu erstellt. Das Löschen ist dauerhaft und unwiderruflich; es gibt keinen Endpoint zum Rückgängigmachen. Falls eine ausgewählte Transaktion in einem finalisierten behördlichen Bericht aufgeführt ist, wird die gesamte Anfrage mit `409` abgelehnt und nichts gelöscht. Der Body verwendet `code: in_filed_report` und benennt jede Transaktion sowie die Berichte, in denen sie aufgeführt ist. Löschen Sie diese Berichte und wiederholen Sie die Anfrage anschließend. operationId: batch_delete_transactions parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID der Organisation. - name: application_id in: path required: true schema: type: string format: uuid description: Anwendungs-UUID. requestBody: required: true content: application/json: schema: type: object oneOf: - title: Selected transactions required: - transaction_uuids properties: transaction_uuids: type: array items: type: string format: uuid description: >- Zu löschende Didit-Transaktions-UUIDs. Erforderlich, sofern `delete_all` nicht true ist. minItems: 1 delete_all: type: boolean enum: - false default: false description: >- Weglassen oder `false` senden, wenn Sie Transaktionen über `transaction_uuids` auswählen. - title: All transactions required: - delete_all properties: delete_all: type: boolean enum: - true description: >- Jede Transaktion in der Anwendung löschen. `transaction_uuids` wird ignoriert. transaction_uuids: type: array items: type: string format: uuid description: Wird ignoriert, wenn `delete_all` true ist. examples: Selected transactions: value: transaction_uuids: - abcdef12-3456-7890-abcd-ef1234567890 - 12345678-90ab-cdef-1234-567890abcdef All transactions: value: delete_all: true responses: '204': description: Ausgewählte Transaktionen gelöscht. '400': description: Es wurde kein Transaktionsselektor angegeben. content: application/json: schema: type: object properties: transaction_uuids: type: array items: type: string example: transaction_uuids: - This field is required unless delete_all is true. '403': description: >- Der API-Schlüssel kann keine Transaktionen löschen. Der Endpoint erfordert `write:transactions`. content: application/json: schema: type: object properties: detail: type: string '409': description: >- Mindestens eine ausgewählte Transaktion ist in einem finalisierten regulatorischen Bericht aufgeführt. Es wird nichts gelöscht. content: application/json: schema: $ref: '#/components/schemas/InFiledReportError' security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl (selected transactions) source: >- curl -X DELETE 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/transactions/delete/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"transaction_uuids": ["abcdef12-3456-7890-abcd-ef1234567890"]}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() client.transactions.batch_delete( body={ "transaction_uuids": ["abcdef12-3456-7890-abcd-ef1234567890", "12345678-90ab-cdef-1234-567890abcdef"], }, ) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. const didit = new Didit(); await didit.transactions.batchDelete({ transaction_uuids: ["abcdef12-3456-7890-abcd-ef1234567890", "12345678-90ab-cdef-1234-567890abcdef"], }); - lang: java label: Java source: >- import java.util.List; import me.didit.Didit; import me.didit.types.TransactionsBatchDeleteParams; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); client.transactions().batchDelete(TransactionsBatchDeleteParams.builder() .putAdditionalProperty("transaction_uuids", List.of("abcdef12-3456-7890-abcd-ef1234567890", "12345678-90ab-cdef-1234-567890abcdef")) .build()); - lang: php label: PHP source: |- transactions->batchDelete([ 'transaction_uuids' => ['abcdef12-3456-7890-abcd-ef1234567890', '12345678-90ab-cdef-1234-567890abcdef'], ]); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new didit.transactions.batch_delete( body: { transaction_uuids: ["abcdef12-3456-7890-abcd-ef1234567890", "12345678-90ab-cdef-1234-567890abcdef"], } ) - lang: csharp label: .NET source: >- using System; using Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); await client.Transactions.BatchDeleteAsync(new TransactionsBatchDeleteParams { TransactionUuids = new string[] { "abcdef12-3456-7890-abcd-ef1234567890", "12345678-90ab-cdef-1234-567890abcdef" }, }); components: schemas: InFiledReportError: type: object description: >- Die Löschung wird verweigert, da sich die ausgewählten Daten in einem abgeschlossenen regulatorischen Bericht befinden. Es wird nichts gelöscht. Löschen Sie den Bericht und wiederholen Sie die Anfrage. required: - detail - code properties: detail: type: string code: type: string enum: - in_filed_report description: >- Stabiler Fehlercode für eine Löschung, die durch einen finalisierten regulatorischen Bericht blockiert wird. reports: type: array items: $ref: '#/components/schemas/FiledRegulatoryReport' description: >- Berichte, die das Löschen einer Person, eines Unternehmens, eines Falls oder einer Sitzung blockieren. transactions: type: array items: $ref: '#/components/schemas/FiledReportTransaction' description: >- Transaktionen, die das Löschen einer Transaktion blockieren, jeweils mit den Berichten, in denen sie aufgeführt sind. FiledRegulatoryReport: type: object description: >- Ein finalisierter regulatorischer Bericht, der die angeforderte Löschung verhindert. required: - uuid - report_number - report_type - case_uuid properties: uuid: type: string format: uuid description: Berichts-UUID. report_number: type: string description: In der Console angezeigte Berichtsnummer (z. B. SAR-0001). report_type: type: string enum: - SAR - STR - CTR - TTR - UTR - IFT - CBR - TFR description: Art des aufsichtsrechtlichen Berichts. case_uuid: type: string format: uuid description: Fall, zu dem der Bericht gehört. FiledReportTransaction: type: object description: >- Eine Transaktion, die nicht gelöscht werden kann, da ein abgeschlossener regulatorischer Bericht sie auflistet. required: - uuid - transaction_id - reports properties: uuid: type: string format: uuid description: Didit-Transaktions-UUID. transaction_id: type: string description: >- Die Transaktionskennung, die bei der Erstellung der Transaktion angegeben wurde. reports: type: array items: $ref: '#/components/schemas/FiledRegulatoryReport' description: Abgeschlossene Berichte, die diese Transaktion aufführen. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.