> ## 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 APIで、監視対象の取引と同じ当事者のvendor_dataを共有するアプリケーション内の他の取引を、新しい順にページネーションで一覧取得します。 関連取引の一覧取得APIプロンプト プロンプトをクリップボードにコピー \

\`List the transactions related to one Didit monitored transaction through the Management API.

Endpoint:
GET https://verification.didit.me/v3/transactions/{transaction_id}/related/

Authentication:
Use the x-api-key header with my Didit API key. A scoped key needs transactions: read. Keys limited to specific workflows or to approved sessions cannot call this endpoint.

Goal:
\- See the other transactions that involve the same people or companies as this one (same applicant, or this transaction's counterparty appearing elsewhere) so I can review a transaction in context.

Path parameter:
\- transaction_id: the Didit transaction uuid, not my own txn_id.

Behavior:
\- A transaction is related when one of its parties, in any role, has the same vendor_data as one of this transaction's parties. Matching uses vendor_data only, within my application.
\- The transaction itself is never returned. Parties without vendor_data are ignored, so if none of this transaction's parties has a vendor_data the result is always empty.
\- Ordered by txn_date, newest first, then created_at.
\- Paginated with limit (default 50) and offset. count is exact up to 100 and capped at 100 above that, so keep following next until it is null.

Example call:
curl -X GET "https://verification.didit.me/v3/transactions/{transaction_id}/related/?limit=50" \
-H "x-api-key: YOUR_API_KEY"

What to read from the response:
\- results[].uuid: use it with GET /v3/transactions/{transaction_id}/ for the full detail.
\- results[].txn_id, status, score, severity, amount, currency, txn_date: the summary of each related transaction.
\- results[].subject_vendor_data and counterparty_vendor_data: which party links it to this transaction.
\- next: URL of the next page, null on the last page.

Failure modes:
\- 400: limit or offset above 1000000.
\- 401: the API key has expired.
\- 403: missing API key (a wrong, revoked or expired key gets 401) ({"detail": "You do not have permission to perform this action."}), a scoped key without transactions: read, a key with workflow or status limits, or a request from outside the key's IP allowlist.
\- 404: no transaction with this uuid in my application ({"detail": "No Transaction matches the given query."}).
\- 429: more than 600 GET requests per minute with this key; wait Retry-After seconds and retry.

Side effects: none. This is a pure read.

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

\
貼り付け先 関連取引は、[取引を送信する](https://docs.didit.me/ja/transaction-monitoring/transactions.md#対象者と取引相手)際に各当事者に付与する`vendor_data`によって紐づけられます。同じ個人または企業には毎回同じ`vendor_data`を送信してください。そうすることで、このエンドポイントは任意の1件の取引を起点に、その当事者の全履歴を返します。これは、Consoleの[取引詳細](https://docs.didit.me/ja/transaction-monitoring/console.md#取引の詳細)にある**関連取引**でレビュアーが確認する一覧と同じものです。各結果は、[取引の一覧取得](https://docs.didit.me/ja/management-api/transactions/list.md)と同じサマリー形式です。当事者、アラート、ルールの実行結果を取得するには、結果の`uuid`を指定して[取引の取得](https://docs.didit.me/ja/management-api/transactions/get.md)を呼び出してください。 ## OpenAPI ````yaml ja/openapi-25.json GET /v3/transactions/{transaction_id}/related/ 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/transactions/{transaction_id}/related/: get: tags: - Transactions summary: 関連する取引を一覧表示 description: >- この取引と同じ人物または企業が関わる、アプリケーション内の他の取引を一覧表示します。いずれかの当事者が、役割を問わず、この取引の当事者のいずれかと同じ`vendor_data`を持つ場合、その取引は関連していると見なされます。この取引自体が返されることはなく、`vendor_data`のない当事者は無視されます。そのため、この取引の当事者がいずれもこれを持たない場合、結果は常に空になります。 結果は`GET /v3/transactions/`のサマリー形式で、新しい順（`txn_date`、次に`created_at`）に並びます。ページネーションには`limit`と`offset`を使用します。`count`は100までは正確な値で、それを超えると上限の100になるため、`next`が`null`になるまでたどってください。 スコープ付きAPIキーには`transactions: read`が必要です。一部のワークフローまたは承認済みセッションに限定されたキーでは、このエンドポイントを呼び出せません。この一覧を完全なものにするには、すべての[取引](https://docs.didit.me/ja/transaction-monitoring/transactions#対象者と取引相手)で、同じ人物または企業に対して同じ`vendor_data`を送信してください。 operationId: list_related_transactions parameters: - name: transaction_id in: path required: true description: >- Diditの取引UUIDで、`POST /v3/transactions/`および`GET /v3/transactions/`が返す`uuid`です。独自の`txn_id`は受け付けられません。 schema: type: string format: uuid example: abcdef12-3456-7890-abcd-ef1234567890 - name: limit in: query required: false schema: type: integer default: 50 minimum: 1 maximum: 1000000 description: 1ページあたりの取引件数です。デフォルトは50です。正の整数でない値は50として扱われ、1000000を超える値は`400`を返します。 - name: offset in: query required: false schema: type: integer maximum: 1000000 minimum: 0 default: 0 description: >- 返す最初の取引の0始まりの位置です。`next`をたどる方法を推奨します。整数でない値は0として扱われ、1000000を超える値は`400`を返します。 responses: '200': description: 関連する取引のページ（新しい順）。 content: application/json: schema: type: object required: - count - next - previous - results properties: count: type: integer description: >- 関連する取引の件数です。100件までは正確な値で、それを超える場合は100で打ち切られます。この値からページを計算せず、`next`をたどってください。 next: type: string format: uri nullable: true description: 次のページの絶対URL。最後のページでは`null`になります。 previous: type: string format: uri nullable: true description: 前のページの絶対URL。最初のページでは`null`になります。 results: type: array items: $ref: '#/components/schemas/TransactionSummary' examples: One related transaction: value: count: 1 next: null previous: null results: - uuid: abcdef99-3456-4890-abcd-ef1234567890 transaction_number: 4087 txn_id: your-txn-2026-10-02-017 transaction_type: finance action_type: deposit status: APPROVED source: LIVE direction: INBOUND amount: '250' currency: EUR currency_type: fiat preferred_currency_amount: '270.08' preferred_currency_code: USD payment_details: Card top-up txn_date: '2026-10-02T14:10:00Z' created_at: '2026-10-02T14:10:03.512244Z' score: 12 severity: LOW decision_reason_code: null decision_reason_label: null tags: [] subject_name: Maria Garcia subject_vendor_data: user-12345 subject_type: user subject_uuid: e1111111-2222-4333-8444-555555555555 counterparty_name: null counterparty_vendor_data: null counterparty_country: null subject_country: ESP assigned_to_name: null travel_rule_status: null application_id: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee application_name: Production app organization_id: 11111111-2222-3333-4444-555555555555 organization_name: Example Org No party has vendor_data: value: count: 0 next: null previous: null results: [] '400': description: '`limit`または`offset`が1000000を超えています。レスポンス本文はオブジェクトではなく、メッセージのJSON配列です。' content: application/json: schema: type: array items: type: string examples: Limit too large: value: - limit must not exceed 1000000. Offset too large: value: - offset must not exceed 1000000. '401': description: >- APIキーの有効期限が切れています。期限切れになるのは有効期限を指定して作成されたキーのみで、その日以降、このキーを使ったすべてのリクエストは`401`を返します。 content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- リクエストは許可されていません。キーがない場合は汎用メッセージが返され、誤った、失効した、または期限切れのキーには`401`が返されます。 content: application/json: schema: type: object properties: detail: type: string examples: Missing or invalid key: value: detail: You do not have permission to perform this action. Scoped key without transactions read: value: detail: This API key has no read access to transactions. Key limited to workflows or approved sessions: value: detail: >- This API key only reaches sessions inside its workflow or status limits, so it can't use this endpoint. Outside the key's IP list: value: detail: This API key can't be used from this IP address. '404': description: >- このUUIDの取引がアプリケーションに存在しません(未作成、削除済み、または別のアプリケーションが所有)。UUIDではない`transaction_id`はAPIに到達せず、このJSONボディの代わりに`404`のHTMLページが返されます。 content: application/json: schema: type: object properties: detail: type: string examples: Not found: value: detail: No Transaction matches the given query. '429': description: >- このAPIキーで1分あたり600件を超えるGETリクエストがありました。`Retry-After`に示された秒数だけ待ってから再試行してください。 content: application/json: schema: type: object properties: detail: type: string examples: Throttled: value: detail: >- GET request rate limit exceeded. You can make up to 600 requests per minute. headers: Retry-After: description: 現在の1分間のウィンドウがリセットされるまでの秒数です。 schema: type: integer example: 23 X-RateLimit-Limit: description: この枠で1分あたりに許可されるリクエスト数。 schema: type: integer X-RateLimit-Remaining: description: 現在のウィンドウで残っているリクエスト数。 schema: type: integer X-RateLimit-Reset: description: ウィンドウがリセットされるUnix時刻。 schema: type: integer security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/transactions/abcdef12-3456-7890-abcd-ef1234567890/related/?limit=50' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() for item in client.transactions.list_related( "abcdef12-3456-7890-abcd-ef1234567890", ): print(item) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); for await (const item of didit.transactions.listRelated("abcdef12-3456-7890-abcd-ef1234567890")) { console.log(item); } - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.Transactions.ListRelatedAutoPaging(ctx, \"abcdef12-3456-7890-abcd-ef1234567890\", didit.TransactionsListRelatedParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); for (var item : client.transactions().listRelated("abcdef12-3456-7890-abcd-ef1234567890")) { System.out.println(item); } - lang: php label: PHP source: >- transactions->listRelated('abcdef12-3456-7890-abcd-ef1234567890') as $item) { print_r($item->toArray()); } - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.transactions.list_related("abcdef12-3456-7890-abcd-ef1234567890").auto_paging_each do |item| puts item.to_h end - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); await foreach (var item in await client.Transactions.ListRelatedAsync("abcdef12-3456-7890-abcd-ef1234567890")) { Console.WriteLine(JsonSerializer.Serialize(item)); } components: schemas: TransactionSummary: type: object description: >- モニタリング対象の取引の概要で、`GET /v3/transactions/`が一覧で返す形式です。関係者、アラート、ルール実行結果を取得するには、`uuid`を指定して`GET /v3/transactions/{transaction_id}/`を呼び出します。 properties: uuid: type: string format: uuid description: Diditの取引UUIDです。取引エンドポイントで`{transaction_id}`として使用します。 transaction_number: type: integer nullable: true description: Consoleに表示される、アプリケーション単位の連番。 txn_id: type: string nullable: true description: 作成呼び出しで指定したお客様独自の識別子です。アプリケーションごとに一意です。 transaction_type: type: string description: >- 保存されている形式のカテゴリ: `finance`、`kyc`、`travelRule`、`userPlatformEvent`、`gamblingBet`、`gamblingLimitChange`、`gamblingBonusChange`、または`auditTrailEvent`。 action_type: type: string description: 'カテゴリ内のサブタイプ。例: `withdrawal`。' status: type: string enum: - APPROVED - IN_REVIEW - DECLINED - AWAITING_USER description: 現在のモニタリング判定。 source: type: string enum: - LIVE - IMPORTED description: モニタリングのために送信された取引は`LIVE`、過去データのインポートは`IMPORTED`です。 direction: type: string enum: - INBOUND - OUTBOUND description: 対象者から見た方向です。 amount: type: string description: 末尾のゼロを除いた10進数文字列で表した金額（小数点以下最大18桁）。 currency: type: string description: '`amount`の通貨コードまたは暗号資産シンボル。' currency_type: type: string nullable: true description: 判明している場合は`fiat`または`crypto`。 preferred_currency_amount: type: string nullable: true description: レートが利用可能な場合に、アプリケーションの優先通貨に換算した`amount`です。 preferred_currency_code: type: string nullable: true description: '`preferred_currency_amount`の通貨。' payment_details: type: string nullable: true description: 自由記述の支払い参照情報。 txn_date: type: string format: date-time description: 取引が発生した日時。 created_at: type: string format: date-time description: Diditが記録した日時です。 score: type: integer description: リスクスコア。値が高いほどリスクが高くなります。 severity: type: string nullable: true enum: - UNKNOWN - LOW - MEDIUM - HIGH - CRITICAL - null description: リスクの重大度。何かによって設定されるまでは`null`です。 decision_reason_code: type: string nullable: true description: 現在の`status`の機械可読な理由。 decision_reason_label: type: string nullable: true description: '`decision_reason_code`の人が読めるラベル。' tags: type: array description: 取引のタグ。 items: type: object properties: uuid: type: string format: uuid name: type: string color: type: string description: '16進カラーコードです。例: `#F59E0B`。' description: type: string nullable: true source: type: string enum: - didit - custom description: Diditのプリセットタグまたはカスタムタグです。 subject_name: type: string nullable: true description: '`APPLICANT`当事者の氏名。' subject_vendor_data: type: string nullable: true description: 申請者に対するお客様の`vendor_data`です。 subject_type: type: string nullable: true enum: - user - business - null description: 申請者がDiditのユーザーまたは企業に紐付いているかどうか。どちらにも紐付いていない場合は`null`です。 subject_uuid: type: string format: uuid nullable: true description: 申請者が紐付けられているDiditのユーザーまたは企業のUUIDです。 subject_country: type: string nullable: true description: 申請者の国コード。 counterparty_name: type: string nullable: true description: '`COUNTERPARTY`当事者の氏名（存在する場合）。' counterparty_vendor_data: type: string nullable: true description: 取引相手に対するお客様の`vendor_data`です。 counterparty_country: type: string nullable: true description: 取引相手の国コード。 assigned_to_name: type: string nullable: true description: 取引に割り当てられたConsoleレビュアーの名前。 travel_rule_status: type: string nullable: true description: 取引のトラベルルール送金のステータスです。送金がない場合は`null`です。 application_id: type: string format: uuid description: 取引を所有するアプリケーション。 application_name: type: string nullable: true description: そのアプリケーションの名前。 organization_id: type: string format: uuid description: アプリケーションを所有する組織です。 organization_name: type: string nullable: true 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.