> ## 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

> Didit Management APIで、監視対象の取引をUUID指定で完全に削除するか、アプリケーション内のすべての取引を削除できます。確定済みのレポートがある場合は削除できません。



取引一括削除APIプロンプト
        プロンプトをクリップボードにコピー



      
      

\<pre>

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

\</pre>



      
      

貼り付け先

モニタリング対象の取引を、UUIDを指定して、またはすべてを一括で完全に削除します。## 削除されるもの削除された取引とともに、その取引だけに属するレコードも削除されます。対象は、当事者、タグ、メモ、決済手段のリンク、書類とそのファイルの保存済みの全バージョン、ルールの実行結果、アラート、プロバイダーの結果、ネットワークのスナップショット、トラベルルールのデータです。ケース、個人、企業は残りますが、削除された取引へのリンクは解除されます。下書きの規制当局向けレポートには削除された取引が表示されなくなり、その取引を除いて再作成されます。削除は完全なもので、元に戻すことはできません。## 削除対象の選択セレクターは必ず1つだけ送信してください。| フィールド | 型 | 説明 |
| - | - | - |
| `transaction_uuids` | UUID\[] | 削除するDiditの取引UUID。`delete_all`が`true`でない限り必須です。 |
| `delete_all` | boolean | アプリケーション内のすべての取引を削除します。`transaction_uuids`は無視されます。 |> [!WARNING]
>
> `delete_all: true`はアプリケーション内のすべての取引を削除します。確認ステップはなく、元に戻すこともできません。## 確定済みレポートによるブロック選択した取引のいずれかが確定済みの規制当局向けレポートに含まれている場合、リクエスト全体が`409`を返し、何も削除されません。```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"
        }
      ]
    }
  ]
}
```[レポートの削除](https://docs.didit.me/ja/management-api/regulatory-reports/delete.md)で各レポートを削除してから、このリクエストを再度実行してください。複数の取引を選択した場合は、ブロックされた取引を除外するか、先にそのレポートを削除してください。## 関連項目- [取引の一覧取得](https://docs.didit.me/ja/management-api/transactions/list.md)
- [取引の取得](https://docs.didit.me/ja/management-api/transactions/get.md)
- [レポートの削除](https://docs.didit.me/ja/management-api/regulatory-reports/delete.md)


## OpenAPI

````yaml ja/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。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: 取引の一括削除
      description: >-
        1件以上の取引を完全に削除します。`transaction_uuids`で対象を選択するか、`delete_all:
        true`でアプリケーション内のすべての取引を削除します。


        取引を削除すると、その取引にのみ属するレコードも一緒に削除されます。対象は、当事者、タグ、メモ、支払い方法のリンク、書類とそのファイルの保存済みバージョンすべて、ルールの実行結果、アラート、プロバイダーの結果、ネットワークのスナップショット、トラベルルールのデータです。ケース、人物、企業は残りますが、削除された取引との紐付けは解除されます。下書きの規制当局向けレポートにはその取引が記載されなくなり、その取引を除いて再作成されます。削除は完全に行われ、元に戻せません。取り消し用のエンドポイントはありません。


        選択した取引のいずれかが確定済みの規制当局向けレポートに記載されている場合、リクエスト全体が`409`で拒否され、何も削除されません。レスポンス本文は`code:
        in_filed_report`を使用し、該当する各取引と、それを記載しているレポートを示します。それらのレポートを削除してから、リクエストを再度実行してください。
      operationId: batch_delete_transactions
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: 組織のUUIDです。
        - name: application_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: アプリケーションの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: 削除するDiditの取引UUIDです。`delete_all`がtrueでない限り必須です。
                      minItems: 1
                    delete_all:
                      type: boolean
                      enum:
                        - false
                      default: false
                      description: '`transaction_uuids`で取引を選択する場合は、省略するか`false`を送信してください。'
                - title: All transactions
                  required:
                    - delete_all
                  properties:
                    delete_all:
                      type: boolean
                      enum:
                        - true
                      description: アプリケーション内のすべての取引を削除します。`transaction_uuids`は無視されます。
                    transaction_uuids:
                      type: array
                      items:
                        type: string
                        format: uuid
                      description: '`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: 削除された選択済みの取引です。
        '400':
          description: 取引のセレクターが指定されていません。
          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: このAPIキーでは取引を削除できません。このエンドポイントには`write:transactions`が必要です。
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
        '409':
          description: 選択した取引のうち少なくとも1件が、確定済みの規制レポートに記載されています。何も削除されません。
          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: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            $didit = new DiditClient();

            $didit->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: >-
        選択したデータが確定済みの規制レポートに含まれているため、削除は拒否されます。何も削除されません。レポートを削除してから、リクエストを繰り返してください。
      required:
        - detail
        - code
      properties:
        detail:
          type: string
        code:
          type: string
          enum:
            - in_filed_report
          description: 確定済みの規制レポートによって削除がブロックされた場合の固定のエラーコード。
        reports:
          type: array
          items:
            $ref: '#/components/schemas/FiledRegulatoryReport'
          description: 人物、企業、ケース、またはセッションの削除を妨げているレポート。
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/FiledReportTransaction'
          description: 取引の削除を妨げている取引と、それぞれの取引を記載しているレポート。
    FiledRegulatoryReport:
      type: object
      description: 要求された削除を妨げる、確定済みの規制当局向けレポート。
      required:
        - uuid
        - report_number
        - report_type
        - case_uuid
      properties:
        uuid:
          type: string
          format: uuid
          description: レポートのUUID。
        report_number:
          type: string
          description: Consoleに表示されるレポート番号（例：SAR-0001）。
        report_type:
          type: string
          enum:
            - SAR
            - STR
            - CTR
            - TTR
            - UTR
            - IFT
            - CBR
            - TFR
          description: 規制当局向けレポートの種類。
        case_uuid:
          type: string
          format: uuid
          description: レポートが属するケース。
    FiledReportTransaction:
      type: object
      description: 確定済みの規制当局向けレポートに記載されているため、削除できない取引。
      required:
        - uuid
        - transaction_id
        - reports
      properties:
        uuid:
          type: string
          format: uuid
          description: Diditの取引UUIDです。
        transaction_id:
          type: string
          description: 取引の作成時に指定された取引識別子。
        reports:
          type: array
          items:
            $ref: '#/components/schemas/FiledRegulatoryReport'
          description: この取引を含む確定済みのレポートです。
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API
        keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください:
        https://docs.didit.me/console/api-keys

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.