> ## 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. # Eliminar transações em lote (API) > Elimine de forma permanente, no Didit, transações por UUID ou todas da aplicação. Um relatório finalizado bloqueia a eliminação. Prompt da API de eliminação em lote de transações 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 Elimine transações monitorizadas de forma permanente, por UUID ou todas de uma vez.## O que é eliminadoUma transação eliminada leva consigo os registos que lhe pertencem exclusivamente: as suas partes, etiquetas, notas, ligações a métodos de pagamento, documentos e todas as versões guardadas dos respetivos ficheiros, execuções de regras, alertas, resultados dos fornecedores, instantâneo da rede e dados da Travel Rule.Os casos, as pessoas e as empresas mantêm-se; a ligação deles à transação eliminada é removida. Os relatórios regulamentares em rascunho deixam de listar a transação eliminada e são reconstruídos sem ela. A eliminação é permanente e irreversível.## Selecionar o que eliminarEnvie exatamente um seletor:| Campo | Tipo | Descrição | | - | - | - | | `transaction_uuids` | UUID\[] | UUIDs de transação do Didit a eliminar. Obrigatório, exceto se `delete_all` for `true`. | | `delete_all` | boolean | Elimina todas as transações da aplicação. `transaction_uuids` é ignorado. |> [!WARNING] > > `delete_all: true` elimina todas as transações da aplicação. Não há passo de confirmação nem forma de desfazer a ação.## Bloqueado por um relatório finalizadoSe alguma das transações selecionadas constar de um relatório regulamentar finalizado, o pedido inteiro devolve `409` e nada é eliminado:```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" } ] } ] } ```Elimine cada relatório com [Eliminar relatório](https://docs.didit.me/pt/management-api/regulatory-reports/delete.md) e, em seguida, repita este pedido. Se tiver selecionado várias transações, remova as bloqueadas ou elimine primeiro os respetivos relatórios.## Relacionados- [Listar transações](https://docs.didit.me/pt/management-api/transactions/list.md) - [Obter transação](https://docs.didit.me/pt/management-api/transactions/get.md) - [Eliminar relatório](https://docs.didit.me/pt/management-api/regulatory-reports/delete.md) ## OpenAPI ````yaml pt/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: Eliminar transações em lote description: >- Elimine permanentemente uma ou mais transações. Selecione-as com `transaction_uuids`, ou elimine todas as transações na aplicação com `delete_all: true`. Uma transação eliminada é removida juntamente com os registos exclusivos da mesma: as suas partes, etiquetas, notas, ligações de métodos de pagamento, documentos e todas as versões armazenadas dos respetivos ficheiros, execuções de regras, alertas, resultados de fornecedores, snapshot de rede e dados de Travel Rule. Casos, pessoas e empresas permanecem; a ligação destes à transação eliminada é desfeita. Os rascunhos de relatórios regulamentares deixam de a listar e são reconstruídos sem ela. A eliminação é permanente e irreversível; não existe qualquer endpoint de anulação. Se alguma transação selecionada constar num relatório regulamentar finalizado, todo o pedido é recusado com `409` e nada é eliminado. O corpo utiliza `code: in_filed_report` e indica cada transação e os relatórios que a listam. Elimine esses relatórios e, em seguida, repita o pedido. 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 de transação Didit a eliminar. Obrigatórios, exceto se `delete_all` for true. minItems: 1 delete_all: type: boolean enum: - false default: false description: >- Omita ou envie `false` quando selecionar transações com `transaction_uuids`. - title: All transactions required: - delete_all properties: delete_all: type: boolean enum: - true description: >- Eliminar todas as transações na 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 eliminadas. '400': description: Nenhum seletor de transações foi fornecido. 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 eliminar transações. O endpoint requer `write:transactions`. content: application/json: schema: type: object properties: detail: type: string '409': description: >- Pelo menos uma transação selecionada está listada num relatório regulamentar finalizado. Nada é eliminado. 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 eliminação foi recusada porque os dados selecionados constam de um relatório regulamentar finalizado. Nada é eliminado. Elimine o relatório e, em seguida, repita o pedido. required: - detail - code properties: detail: type: string code: type: string enum: - in_filed_report description: >- Código de erro estável para uma eliminação bloqueada por um relatório regulamentar finalizado. reports: type: array items: $ref: '#/components/schemas/FiledRegulatoryReport' description: >- Relatórios que bloqueiam a eliminação de uma pessoa, empresa, caso ou sessão. transactions: type: array items: $ref: '#/components/schemas/FiledReportTransaction' description: >- Transações que bloqueiam a eliminação de uma transação, cada uma com os relatórios que a listam. FiledRegulatoryReport: type: object description: Um relatório regulamentar finalizado que impede a eliminação pedida. 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 apresentado na Consola (por exemplo, SAR-0001). report_type: type: string enum: - SAR - STR - CTR - TTR - UTR - IFT - CBR - TFR description: Tipo de relatório regulamentar. 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 eliminada porque um relatório regulamentar finalizado a inclui. required: - uuid - transaction_id - reports properties: uuid: type: string format: uuid description: UUID da transação Didit. transaction_id: type: string description: >- O identificador de transação fornecido aquando da criação da transação. reports: type: array items: $ref: '#/components/schemas/FiledRegulatoryReport' description: Relatórios finalizados que listam esta transação. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, 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á incorreta, 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 o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.