> ## 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 Travel Rule na API

> Consulte na Didit o histórico completo de entregas Travel Rule de uma transação: paginação, tipos de transporte, estado e datas.

Prompt da API de histórico de entregas da 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 da Travel Rule da Didit devolve todas as entradas de entrega de uma transação, paginadas da mais antiga para a mais recente.

Utilize a sua `x-api-key` com permissão de leitura sobre transações. `transaction_id` é o UUID da transação na Didit. Se a transação ou a transferência não existirem, a resposta é `404`; se a permissão for insuficiente, a resposta é `403`.

## Paginação e ordenação

A resposta contém `count`, `next`, `previous` e `results`. `limit` tem como valor por omissão 100 e está limitado a 100; `offset` tem como valor por omissão zero e não pode exceder 1,000,000, caso em que devolve `400`. `count` está normalmente limitado a 100 e não é um total fiável para históricos maiores. Siga `next` até ser `null`, independentemente do valor 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 estado, sem erros em bruto nem payloads de transporte.

## Histórico incorporado

O [detalhe da transação](https://docs.didit.me/pt/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 foram omitidas entradas mais antigas. As listas de transações omitem estes dois campos de histórico. O campo existente `delivery` continua a descrever a entrega mais recente.

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


## OpenAPI

````yaml pt/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. Ao
        contrário das 100 entradas mais recentes incluídas no detalhe, este
        endpoint pagina o histórico completo. Consulte [histórico de
        entregas](/pt/management-api/travel-rule/list-deliveries).
      operationId: listTravelRuleDeliveries
      parameters:
        - name: transaction_id
          in: path
          required: true
          description: UUID de transação estável da Didit proprietário da transferência.
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 1000000
            default: 100
          description: >-
            Entradas por página. Por defeito, 100; valores superiores são
            limitados a 100; um valor acima de 1,000,000 devolve `400`.
        - name: offset
          in: query
          schema:
            type: integer
            maximum: 1000000
            minimum: 0
            default: 0
          description: >-
            Número de entradas a ignorar, até 1,000,000. Um valor superior
            devolve `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 em falta, inválida ou revogada, ou a chave não pode ler
            as transações desta aplicação. Uma chave em falta devolve `403`; uma
            chave incorreta, revogada ou expirada devolve `401`.
        '404':
          description: Transação ou transferência 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: >-
            A contagem está normalmente limitada a 100; não é um total fiável
            para históricos maiores. Siga next até null, independentemente da
            contagem.
        next:
          type: string
          format: uri
          nullable: true
          description: URL da página seguinte, 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, por data de
            criação e, depois, por identificador.
    TravelRuleDeliveryLogEntry:
      type: object
      description: Uma entrada independente do 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
            quando é enviada). `ANSWER`: a sua aceitação ou recusa, devida à
            rede requerente (de entrada). `TXID`: o hash da transação on-chain,
            após concluir a transferência. `CANCEL`: o cancelamento, após
            cancelá-la. `POLL`: uma consulta de estado a uma rede que o
            disponibilize, repetida a cada 5 minutos enquanto a transferência
            aguarda a contraparte.
        status:
          type: string
          enum:
            - QUEUED
            - SENDING
            - RETRYING
            - DELIVERED
            - FAILED
          description: Estado atual da entrega.
        rail:
          type: string
          nullable: true
          enum:
            - EMAIL
            - TRP
            - INTERNAL
            - NETWORK
            - null
          description: >-
            Tipo de transporte neutro em relação 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 de mensagem legível e estado de entrega. Não expõe payloads de
            transporte nem erros em bruto.
      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: >-
        A chave de API da sua aplicação, a partir de Programadores -> Chaves de
        API na Business Console. A chave principal tem acesso total. Uma chave
        nomeada pode ter o âmbito definido: nenhum, 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á
        incorreta, 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 o
        pedido veio de um endereço fora da sua lista de IP; 404 numa rota de
        sessão significa que a sessão está fora dos fluxos ou estados da chave.
        Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs
        como nulos, e uma chave sem permissão de escrita em sessões recebe
        ligações de sessão e tokens como nulos. Consulte
        https://docs.didit.me/console/api-keys.

````

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