> ## 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で、取引のトラベルルール配信履歴を全件取得できます。ページネーション、転送方式、メッセージステータス、配信日時を含みます。

トラベルルール配信履歴APIプロンプト
プロンプトをクリップボードにコピー

<pre>
  \`Read the complete Travel Rule delivery history for one transaction.

  Endpoint:
  GET [https://verification.didit.me/v3/transactions/\{transaction\_id}/travel-rule/deliveries/](https://verification.didit.me/v3/transactions/\{transaction_id}/travel-rule/deliveries/)

  Authentication:
  Use the x-api-key header with my Didit API key. {transaction_id} is the Didit transaction uuid on my application. The key needs transaction read permission.

  Query parameters:

  * limit - entries per page, default 100; larger values are capped at 100, and a value above 1,000,000 returns 400.
  * offset - entries to skip, default 0, up to 1,000,000; a larger value returns 400.

  What to read from the response:

  * count, next, previous, results. count is capped at 100 and is not a reliable total for larger histories; follow next until it is null.
  * Entries are ordered oldest first, then by identifier for ties. Each has uuid, kind (SEND, ANSWER, TXID, CANCEL, POLL), status (QUEUED, SENDING, RETRYING, DELIVERED, FAILED), rail (EMAIL, TRP, INTERNAL, NETWORK, or null before selection), created\_at, delivered\_at and detail\_lines.
  * detail\_lines describes the message kind and status without transport payloads or raw errors. The rail is supplier-neutral: NETWORK collapses every named network into one value.

  Transaction detail embeds only the newest 100 entries as travel\_rule.deliveries, with travel\_rule.deliveries\_truncated when older ones were omitted. Transaction lists omit both fields. travel\_rule.delivery remains the newest entry only.

  Failure modes:

  * 400 - limit or offset above 1,000,000.
  * 401 - a wrong, revoked or expired API key.
  * 403 - the x-api-key header is missing, or the key lacks transaction read permission.
  * 404 - unknown transaction, no Travel Rule transfer, or a deleted transaction.

  Full guide: /transaction-monitoring/travel-rule#delivery-and-retries.\`
</pre>

貼り付け先

Diditのトラベルルール配信履歴APIは、取引に関するすべての配信エントリーを、古い順にページネーションして返します。

取引の読み取り権限を持つ`x-api-key`を使用してください。`transaction_id`は、Didit取引のUUIDです。取引または送金が存在しない場合は`404`を返します。権限が不足している場合は`403`を返します。

## ページネーションと並び順

レスポンスには`count`、`next`、`previous`、`results`が含まれます。`limit`のデフォルト値は100で、上限も100です。`offset`のデフォルト値は0で、1,000,000を超えてはならず、超えた場合は`400`が返されます。`count`は通常100が上限で、件数の多い履歴では信頼できる総数ではありません。`count`の値にかかわらず、`next`が`null`になるまでたどってください。エントリは作成日時順に並び、作成日時が同じ場合は識別子順に並びます。

各エントリには`uuid`、`kind`、`status`、`rail`、`created_at`、`delivered_at`、`detail_lines`があります。`rail`は`EMAIL`、`TRP`、`INTERNAL`、`NETWORK`のいずれか、または選択前の場合は`null`です。`detail_lines`には、メッセージの種類とステータスが記載されます。生のエラーや転送ペイロードは含まれません。

## 埋め込み履歴

[取引の詳細](https://docs.didit.me/ja/management-api/transactions/get.md)には、`travel_rule.deliveries`の最新100件のエントリーのみが、古い順に表示されます。`deliveries_truncated`で、それより古いエントリーが省略されているかどうかを確認できます。取引一覧には、この2つの履歴フィールドは含まれません。既存の`delivery`フィールドは、引き続き最新の配信を表します。

ステータスの意味については、[配信と再試行](https://docs.didit.me/ja/transaction-monitoring/travel-rule.md#配信と再試行)を参照してください。[取引相手メッセージ](https://docs.didit.me/ja/management-api/travel-rule/list-messages.md)は、別の会話用エンドポイントです。


## OpenAPI

````yaml ja/openapi-25.json GET /v3/transactions/{transaction_id}/travel-rule/deliveries/
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}/travel-rule/deliveries/:
    get:
      tags:
        - Travel Rule
      summary: トラベルルールの配信履歴を一覧表示します
      description: >-
        取引の配信履歴全体を、古いものから順に読み取ります。取引の読み取り権限が必要です。詳細に埋め込まれた最新100件とは異なり、このエンドポイントは履歴全体をページ分割して返します。[配信履歴](/ja/management-api/travel-rule/list-deliveries)を参照してください。
      operationId: listTravelRuleDeliveries
      parameters:
        - name: transaction_id
          in: path
          required: true
          description: この送金を所有する取引の、Diditの安定したUUIDです。
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 1000000
            default: 100
          description: >-
            1ページあたりのエントリ数。デフォルトは100で、100より大きい値は100に制限されます。1,000,000を超える値は`400`を返します。
        - name: offset
          in: query
          schema:
            type: integer
            maximum: 1000000
            minimum: 0
            default: 0
          description: スキップするエントリ数（最大1,000,000）。これより大きい値を指定すると`400`が返されます。
      responses:
        '200':
          description: 配信履歴をページ単位で取得します。古い順に並びます。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TravelRuleDeliveryLogPage'
              example:
                count: 1
                next: null
                previous: null
                results:
                  - uuid: 11111111-2222-4333-8444-555555555555
                    kind: SEND
                    status: DELIVERED
                    rail: NETWORK
                    created_at: '2026-11-01T10:00:00Z'
                    delivered_at: '2026-11-01T10:00:01Z'
                    detail_lines:
                      - Send
                      - Delivered
        '400':
          description: 1,000,000を超える`limit`または`offset`が送信されました。
        '401':
          description: 誤った、失効した、または期限切れのAPIキー。
        '403':
          description: >-
            APIキーがない、無効、または失効しているか、このアプリケーションの取引を読み取る権限がキーにありません。キーがない場合は`403`を返し、誤った、失効した、または期限切れのキーの場合は`401`を返します。
        '404':
          description: 取引またはトラベルルール送金が見つかりません。
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X GET
            'https://verification.didit.me/v3/transactions/11111111-2222-3333-4444-555555555555/travel-rule/deliveries/?limit=100&offset=0'
            \
              -H 'x-api-key: YOUR_API_KEY'
components:
  schemas:
    TravelRuleDeliveryLogPage:
      type: object
      required:
        - count
        - next
        - previous
        - results
      properties:
        count:
          type: integer
          minimum: 0
          description: >-
            件数は通常100件を上限とします。履歴が大きい場合は信頼できる合計ではありません。countの値に関係なく、nextがnullになるまでたどってください。
        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/TravelRuleDeliveryLogEntry'
          description: 作成日時の古い順に並べ、次に識別子順に並べたエントリ。
    TravelRuleDeliveryLogEntry:
      type: object
      description: 配信履歴の1件分のエントリ。ベンダー非依存の形式です。
      required:
        - uuid
        - kind
        - status
        - rail
        - created_at
        - delivered_at
        - detail_lines
      properties:
        uuid:
          type: string
          format: uuid
          description: 配信の識別子。
        kind:
          type: string
          enum:
            - SEND
            - ANSWER
            - TXID
            - CANCEL
            - POLL
          description: >-
            メッセージが運ぶ内容です。`SEND`:
            送金における取引相手への最初のメッセージです（送信。経路は送信時に選択されます）。`ANSWER`:
            お客様の承認または拒否で、問い合わせてきたネットワークに返す必要があります（受信）。`TXID`:
            お客様が送金を完了した後の、オンチェーンの取引ハッシュです。`CANCEL`:
            お客様が送金をキャンセルした後の、キャンセル通知です。`POLL`:
            ステータス照会を提供するネットワークへの照会で、送金が取引相手を待っている間、5分ごとに繰り返されます。
        status:
          type: string
          enum:
            - QUEUED
            - SENDING
            - RETRYING
            - DELIVERED
            - FAILED
          description: 現在の配信ステータス。
        rail:
          type: string
          nullable: true
          enum:
            - EMAIL
            - TRP
            - INTERNAL
            - NETWORK
            - null
          description: サプライヤーに依存しないトランスポートの種類。選択されるまではnull。
        created_at:
          type: string
          format: date-time
          description: 配信が作成された日時。
        delivered_at:
          type: string
          format: date-time
          nullable: true
          description: 配信が完了した日時。完了していない場合は null。
        detail_lines:
          type: array
          items:
            type: string
          description: 人が読める形式のメッセージの種類と配信ステータスです。トランスポートのペイロードや生のエラーは公開されません。
      example:
        uuid: 11111111-2222-4333-8444-555555555555
        kind: SEND
        status: DELIVERED
        rail: NETWORK
        created_at: '2026-11-01T10:00:00Z'
        delivered_at: '2026-11-01T10:00:01Z'
        detail_lines:
          - Send
          - Delivered
  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.