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

# Travel Rule 전송 이력 API

> Didit Travel Rule 전송 이력 API로 거래별 전체 전송 기록을 조회하세요. 페이지네이션, 전송 유형, 메시지 상태, 전송 시각을 포함합니다.

Travel Rule 전송 내역 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의 Travel Rule 전송 내역 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`는 메시지 종류와 상태를 설명하며, 원시 오류나 전송 payload는 포함하지 않습니다.

## 포함된 이력

[거래 상세](https://docs.didit.me/ko/management-api/transactions/get.md)에는 `travel_rule.deliveries`의 최신 항목 100개만 포함되며, 오래된 항목부터 표시됩니다. `deliveries_truncated`는 더 오래된 항목이 생략되었는지 여부를 알려 줍니다. 거래 목록에서는 이 두 이력 필드가 생략됩니다. 기존 `delivery` 필드는 계속해서 가장 최근 전송을 나타냅니다.

상태의 의미는 [전송 및 재시도](https://docs.didit.me/ko/transaction-monitoring/travel-rule.md#전송-및-재시도)를 참고하십시오. [거래 상대방 메시지](https://docs.didit.me/ko/management-api/travel-rule/list-messages.md)는 별도의 대화 endpoint입니다.


## OpenAPI

````yaml ko/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: Travel Rule 전송 기록 목록 조회
      description: >-
        거래의 전체 전송 기록을 가장 오래된 순서로 읽습니다. 거래 읽기 권한이 필요합니다. 상세 정보에 포함된 최근 100개 항목과
        달리 이 엔드포인트는 전체 기록을 페이지로 나누어 제공합니다. [전송
        기록](/ko/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: >-
            페이지당 항목 수. 기본값은 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: 거래 또는 Travel Rule 전송을 찾을 수 없습니다.
      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: >-
            count는 보통 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: 전송 기록의 공급업체 중립 항목 하나입니다.
      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: 사람이 읽을 수 있는 메시지 종류와 전송 상태입니다. 전송 payload나 원시 오류는 노출하지 않습니다.
      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: >-
        Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본
        키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며
        특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나
        만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된
        IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를
        벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write
        권한이 없는 키는 세션 링크와 token을 null로 수신합니다.
        https://docs.didit.me/console/api-keys 를 참고하십시오.

````

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