> ## 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. # API de exclusão em lote de transações > Exclua permanentemente transações monitoradas na Didit por UUID ou todas as da aplicação. Um relatório finalizado bloqueia a exclusão. Prompt da API de exclusão de transações em lote Copiar o prompt para a área de transferência \

\`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.`

\
Colar em Exclua permanentemente as transações monitoradas por UUID ou todas de uma vez.## O que é excluídoUma transação excluída leva consigo os registros que pertencem apenas a ela: suas partes, tags, notas, vínculos com métodos de pagamento, documentos e todas as versões armazenadas de seus arquivos, execuções de regras, alertas, resultados de provedores, snapshot da rede e dados de Travel Rule.Casos, pessoas e empresas permanecem; o vínculo deles com a transação excluída é removido. Os relatórios regulatórios em rascunho deixam de listar a transação excluída e são reconstruídos sem ela. A exclusão é permanente e irreversível.## Selecione o que excluirEnvie exatamente um seletor:| Campo | Tipo | Descrição | | - | - | - | | `transaction_uuids` | UUID\[] | UUIDs das transações da Didit a excluir. Obrigatório, a menos que `delete_all` seja `true`. | | `delete_all` | boolean | Exclui todas as transações da aplicação. `transaction_uuids` é ignorado. |> [!WARNING] > > `delete_all: true` exclui todas as transações da aplicação. Não há etapa de confirmação nem como desfazer.## Bloqueio por relatório finalizadoSe alguma transação selecionada estiver listada em um relatório regulatório finalizado, a requisição inteira retorna `409` e nada é excluído:```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" } ] } ] } ```Exclua cada relatório com [Excluir relatório](https://docs.didit.me/pt-br/management-api/regulatory-reports/delete.md) e repita esta requisição. Se você selecionou várias transações, remova as bloqueadas ou exclua os relatórios delas primeiro.## Relacionados- [Listar transações](https://docs.didit.me/pt-br/management-api/transactions/list.md) - [Obter transação](https://docs.didit.me/pt-br/management-api/transactions/get.md) - [Excluir relatório](https://docs.didit.me/pt-br/management-api/regulatory-reports/delete.md) ## OpenAPI ````yaml pt-br/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 de verificação de identidade. Autentique-se com o cabeçalho x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/transactions/delete/: delete: tags: - Transactions summary: Excluir transações em lote description: >- Exclui uma ou mais transações de forma permanente. Selecione-as com `transaction_uuids` ou exclua todas as transações da aplicação com `delete_all: true`. Uma transação excluída leva consigo os registros que pertencem apenas a ela: suas partes, tags, notas, vínculos com métodos de pagamento, documentos e todas as versões armazenadas de seus arquivos, execuções de regras, alertas, resultados de provedores, snapshot da rede e dados de Travel Rule. Casos, pessoas e empresas são mantidos, e o vínculo deles com a transação excluída é removido. Os relatórios regulatórios em rascunho deixam de listá-la e são reconstruídos sem ela. A exclusão é permanente e irreversível; não existe endpoint para desfazê-la. Se alguma transação selecionada estiver listada em um relatório regulatório finalizado, a requisição inteira é recusada com `409` e nada é excluído. O corpo usa `code: in_filed_report` e identifica cada transação e os relatórios que a listam. Exclua esses relatórios e repita a requisição. operationId: batch_delete_transactions parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID da organização. - name: application_id in: path required: true schema: type: string format: uuid description: UUID da aplicação. 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: >- UUIDs das transações na Didit a excluir. Obrigatório, a menos que `delete_all` seja true. minItems: 1 delete_all: type: boolean enum: - false default: false description: >- Omita ou envie `false` quando você selecionar transações com `transaction_uuids`. - title: All transactions required: - delete_all properties: delete_all: type: boolean enum: - true description: >- Exclui todas as transações da aplicação. `transaction_uuids` é ignorado. transaction_uuids: type: array items: type: string format: uuid description: Ignorado quando `delete_all` é true. 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: Transações selecionadas excluídas. '400': description: Nenhum seletor de transação foi informado. 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: >- A chave de API não pode excluir transações. O endpoint exige `write:transactions`. content: application/json: schema: type: object properties: detail: type: string '409': description: >- Pelo menos uma das transações selecionadas consta em um relatório regulatório finalizado. Nada é excluído. 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: >- A exclusão é recusada porque os dados selecionados estão em um relatório regulatório finalizado. Nada é excluído. Exclua o relatório e repita a requisição. required: - detail - code properties: detail: type: string code: type: string enum: - in_filed_report description: >- Código de erro estável para uma exclusão bloqueada por um relatório regulatório finalizado. reports: type: array items: $ref: '#/components/schemas/FiledRegulatoryReport' description: >- Relatórios que bloqueiam a exclusão de uma pessoa, empresa, caso ou sessão. transactions: type: array items: $ref: '#/components/schemas/FiledReportTransaction' description: >- Transações que impedem a exclusão de uma transação, cada uma com os relatórios que a listam. FiledRegulatoryReport: type: object description: Um relatório regulatório finalizado que impede a exclusão solicitada. required: - uuid - report_number - report_type - case_uuid properties: uuid: type: string format: uuid description: UUID do relatório. report_number: type: string description: Número do relatório exibido no Console (por exemplo, SAR-0001). report_type: type: string enum: - SAR - STR - CTR - TTR - UTR - IFT - CBR - TFR description: Tipo de relatório regulatório. case_uuid: type: string format: uuid description: Caso ao qual o relatório pertence. FiledReportTransaction: type: object description: >- Uma transação que não pode ser excluída porque um relatório regulatório finalizado a inclui. required: - uuid - transaction_id - reports properties: uuid: type: string format: uuid description: UUID da transação na Didit. transaction_id: type: string description: >- O identificador da transação informado quando a transação foi criada. reports: type: array items: $ref: '#/components/schemas/FiledRegulatoryReport' description: Relatórios finalizados que incluem esta transação. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.