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

# Histórico de entregas do Travel Rule via API

> Consulte o histórico completo de entregas do Travel Rule na Didit: paginação, tipos de transporte, status das mensagens e datas de entrega.

Prompt da API de histórico de entregas do Travel Rule
Copiar o prompt para a área de transferência

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

Colar em

A API de histórico de entregas do Travel Rule da Didit retorna todas as entradas de entrega de uma transação, paginadas da mais antiga para a mais recente.

Use sua `x-api-key` com a permissão de leitura de transações. `transaction_id` é o UUID da transação na Didit. Uma transação ou transferência inexistente retorna `404`; permissão insuficiente retorna `403`.

## Paginação e ordenação

A resposta contém `count`, `next`, `previous` e `results`. `limit` tem como padrão 100 e é limitado a 100; `offset` tem como padrão zero e não pode exceder 1,000,000, caso contrário retorna `400`. `count` normalmente é limitado a 100 e não é um total confiável para históricos maiores. Siga `next` até que ele seja `null`, independentemente de `count`. As entradas são ordenadas pela data de criação e, em caso de empate, pelo identificador.

Cada entrada tem `uuid`, `kind`, `status`, `rail`, `created_at`, `delivered_at` e `detail_lines`. `rail` é `EMAIL`, `TRP`, `INTERNAL`, `NETWORK` ou `null` antes da seleção. `detail_lines` descreve o tipo de mensagem e o status, sem erros brutos ou payloads de transporte.

## Histórico incorporado

[Detalhe da transação](https://docs.didit.me/pt-br/management-api/transactions/get.md) inclui apenas as 100 entradas mais recentes em `travel_rule.deliveries`, apresentadas da mais antiga para a mais recente. `deliveries_truncated` indica se entradas mais antigas foram omitidas. Listas de transações omitem esses dois campos de histórico. O campo existente `delivery` continua descrevendo a entrega mais recente.

Consulte [entrega e novas tentativas](https://docs.didit.me/pt-br/transaction-monitoring/travel-rule.md#entrega-e-novas-tentativas) para o significado dos status. [Mensagens da contraparte](https://docs.didit.me/pt-br/management-api/travel-rule/list-messages.md) são um endpoint de conversa separado.


## OpenAPI

````yaml pt-br/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 de verificação de identidade. Autentique-se com o cabeçalho x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/transactions/{transaction_id}/travel-rule/deliveries/:
    get:
      tags:
        - Travel Rule
      summary: Listar o histórico de entregas da Travel Rule
      description: >-
        Lê o histórico completo de entregas de uma transação, do mais antigo
        para o mais recente. Requer permissão de leitura de transações.
        Diferente das 100 entradas mais recentes incluídas nos detalhes, este
        endpoint pagina o histórico completo. Veja [histórico de
        entregas](/pt-br/management-api/travel-rule/list-deliveries).
      operationId: listTravelRuleDeliveries
      parameters:
        - name: transaction_id
          in: path
          required: true
          description: UUID estável da transação na Didit à qual a transferência pertence.
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 1000000
            default: 100
          description: >-
            Entradas por página. O padrão é 100, e valores maiores são limitados
            a 100; um valor acima de 1.000.000 retorna `400`.
        - name: offset
          in: query
          schema:
            type: integer
            maximum: 1000000
            minimum: 0
            default: 0
          description: >-
            Número de entradas a pular, até 1.000.000. Um valor maior retorna
            `400`.
      responses:
        '200':
          description: Histórico de entregas paginado, do mais antigo para o mais recente.
          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: Foi enviado um `limit` ou `offset` acima de 1,000,000.
        '401':
          description: Uma chave de API incorreta, revogada ou expirada.
        '403':
          description: >-
            Chave de API ausente, inválida ou revogada, ou a chave não pode ler
            as transações desta aplicação. Uma chave ausente retorna `403`; uma
            chave incorreta, revogada ou expirada retorna `401`.
        '404':
          description: Transação ou transferência do Travel Rule não encontrada.
      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: >-
            Contagem normalmente limitada a 100; não é um total confiável para
            históricos maiores. Siga next até null, independentemente de count.
        next:
          type: string
          format: uri
          nullable: true
          description: URL da próxima página, ou null.
        previous:
          type: string
          format: uri
          nullable: true
          description: URL da página anterior, ou null.
        results:
          type: array
          items:
            $ref: '#/components/schemas/TravelRuleDeliveryLogEntry'
          description: >-
            Entradas ordenadas da mais antiga para a mais recente pela data de
            criação e, em seguida, pelo identificador.
    TravelRuleDeliveryLogEntry:
      type: object
      description: Uma entrada neutra em relação ao fornecedor no histórico de entregas.
      required:
        - uuid
        - kind
        - status
        - rail
        - created_at
        - delivered_at
        - detail_lines
      properties:
        uuid:
          type: string
          format: uuid
          description: Identificador da entrega.
        kind:
          type: string
          enum:
            - SEND
            - ANSWER
            - TXID
            - CANCEL
            - POLL
          description: >-
            O que a mensagem transporta. `SEND`: a primeira mensagem da
            transferência para a contraparte (de saída; o canal é escolhido no
            momento do envio). `ANSWER`: sua aceitação ou recusa, devida à rede
            que fez a solicitação (de entrada). `TXID`: o hash da transação
            on-chain, depois que você conclui a transferência. `CANCEL`: o
            cancelamento, depois que você cancela a transferência. `POLL`: uma
            consulta de status a uma rede que oferece esse recurso, repetida a
            cada 5 minutos enquanto a transferência aguarda a contraparte.
        status:
          type: string
          enum:
            - QUEUED
            - SENDING
            - RETRYING
            - DELIVERED
            - FAILED
          description: Status atual da entrega.
        rail:
          type: string
          nullable: true
          enum:
            - EMAIL
            - TRP
            - INTERNAL
            - NETWORK
            - null
          description: >-
            Tipo de transporte neutro quanto ao fornecedor; null até ser
            selecionado.
        created_at:
          type: string
          format: date-time
          description: Quando a entrega foi criada.
        delivered_at:
          type: string
          format: date-time
          nullable: true
          description: Quando a entrega foi concluída, ou null.
        detail_lines:
          type: array
          items:
            type: string
          description: >-
            Tipo da mensagem e status da entrega, legíveis por humanos. Não
            expõe payloads de transporte nem erros brutos.
      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: >-
        Chave de API da sua aplicação, em Developers -> API keys no Business
        Console. A chave principal tem acesso total. Uma chave nomeada pode ter
        escopo restrito: nenhum acesso, 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á errada, 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 a requisição veio de um
        endereço fora da sua lista de IPs; 404 em uma rota de sessão significa
        que a sessão está fora dos fluxos ou status da chave. Uma chave sem
        acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave
        sem permissão de escrita em sessões recebe links e tokens de sessão como
        null. Consulte https://docs.didit.me/console/api-keys.

````

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