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

# Historial de lliuraments de la Travel Rule API

> Consulta amb Didit l'historial complet de lliuraments de la Travel Rule d'una transacció, amb paginació, transport, estat i marques de temps.

Prompt de l'API d'historial de lliuraments de Travel Rule
Copia el prompt al porta-retalls

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

Enganxa a

L'API d'historial de lliuraments de Travel Rule de Didit retorna totes les entrades de lliurament d'una transacció, paginades de la més antiga a la més recent.

Utilitza la teva `x-api-key` amb permís de lectura de transaccions. `transaction_id` és l'UUID de la transacció de Didit. Si no es troba la transacció o la transferència, es retorna `404`; si el permís és insuficient, es retorna `403`.

## Paginació i ordenació

La resposta conté `count`, `next`, `previous` i `results`. `limit` té per defecte 100 i està limitat a 100; `offset` té per defecte zero i no pot superar 1.000.000, cosa que retorna `400`. Normalment `count` està limitat a 100 i no és un total fiable per a historials més llargs. Segueix `next` fins que sigui `null`, independentment de `count`. Les entrades s'ordenen per data de creació i, en cas d'empat, per identificador.

Cada entrada té `uuid`, `kind`, `status`, `rail`, `created_at`, `delivered_at` i `detail_lines`. `rail` és `EMAIL`, `TRP`, `INTERNAL`, `NETWORK` o `null` abans de la selecció. `detail_lines` descriu el tipus de missatge i l'estat sense errors bruts ni payloads de transport.

## Historial incrustat

[Detall de la transacció](https://docs.didit.me/ca/management-api/transactions/get.md) inclou només les 100 entrades més recents de `travel_rule.deliveries`, presentades de més antiga a més recent. `deliveries_truncated` indica si s'han omès entrades més antigues. Les llistes de transaccions no inclouen aquests dos camps d'historial. El camp existent `delivery` continua descrivint el lliurament més recent.

Consulta [lliurament i reintents](https://docs.didit.me/ca/transaction-monitoring/travel-rule.md#lliurament-i-reintents) per veure el significat dels estats. Els [missatges de la contrapart](https://docs.didit.me/ca/management-api/travel-rule/list-messages.md) són un endpoint de conversa independent.


## OpenAPI

````yaml ca/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 verificació d'identitat. Autentica't amb la capçalera x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/transactions/{transaction_id}/travel-rule/deliveries/:
    get:
      tags:
        - Travel Rule
      summary: Llista l'historial de lliurament de la Travel Rule
      description: >-
        Llegeix l'historial complet de lliuraments d'una transacció, del més
        antic al més recent. Requereix permís de lectura de transaccions. A
        diferència de les 100 entrades més recents incloses en el detall, aquest
        endpoint pagina l'historial complet. Consulta [historial de
        lliuraments](/ca/management-api/travel-rule/list-deliveries).
      operationId: listTravelRuleDeliveries
      parameters:
        - name: transaction_id
          in: path
          required: true
          description: UUID de transacció estable de Didit que posseeix la transferència.
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 1000000
            default: 100
          description: >-
            Entrades per pàgina. El valor per defecte és 100, i els valors més
            grans es limiten a 100; un valor superior a 1,000,000 retorna `400`.
        - name: offset
          in: query
          schema:
            type: integer
            maximum: 1000000
            minimum: 0
            default: 0
          description: >-
            Nombre d'entrades que s'han d'ometre, fins a 1.000.000. Un valor més
            gran retorna `400`.
      responses:
        '200':
          description: Historial de lliuraments paginat, de més antic a més recent.
          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: S'ha enviat un `limit` o un `offset` superior a 1.000.000.
        '401':
          description: Una clau d'API incorrecta, revocada o caducada.
        '403':
          description: >-
            Clau d'API absent, no vàlida o revocada, o bé la clau no pot llegir
            les transaccions d'aquesta aplicació. Una clau absent retorna `403`;
            una clau incorrecta, revocada o caducada retorna `401`.
        '404':
          description: No s'ha trobat la transacció o la transferència de la 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: >-
            El recompte normalment està limitat a 100; no és un total fiable per
            a històrics més grans. Segueix next fins que sigui null,
            independentment de count.
        next:
          type: string
          format: uri
          nullable: true
          description: URL de la pàgina següent, o null.
        previous:
          type: string
          format: uri
          nullable: true
          description: URL de la pàgina anterior, o null.
        results:
          type: array
          items:
            $ref: '#/components/schemas/TravelRuleDeliveryLogEntry'
          description: >-
            Entrades ordenades de la més antiga a la més recent segons l'hora de
            creació i, després, l'identificador.
    TravelRuleDeliveryLogEntry:
      type: object
      description: Una entrada neutra respecte al proveïdor a l'historial de lliuraments.
      required:
        - uuid
        - kind
        - status
        - rail
        - created_at
        - delivered_at
        - detail_lines
      properties:
        uuid:
          type: string
          format: uuid
          description: Identificador del lliurament.
        kind:
          type: string
          enum:
            - SEND
            - ANSWER
            - TXID
            - CANCEL
            - POLL
          description: >-
            Què transmet el missatge. `SEND`: el primer missatge de la
            transferència a la contrapart (sortint; el canal es tria quan
            s'envia). `ANSWER`: la teva acceptació o rebuig, que es deu a la
            xarxa que ho ha sol·licitat (entrant). `TXID`: el hash de la
            transacció on-chain, un cop finalitzis la transferència. `CANCEL`:
            la cancel·lació, un cop la cancel·lis. `POLL`: una consulta d'estat
            a una xarxa que n'ofereixi una, repetida cada 5 minuts mentre la
            transferència espera la contrapart.
        status:
          type: string
          enum:
            - QUEUED
            - SENDING
            - RETRYING
            - DELIVERED
            - FAILED
          description: Estat de lliurament actual.
        rail:
          type: string
          nullable: true
          enum:
            - EMAIL
            - TRP
            - INTERNAL
            - NETWORK
            - null
          description: >-
            Tipus de transport neutral respecte al proveïdor; null fins que se
            n'hagi seleccionat un.
        created_at:
          type: string
          format: date-time
          description: Quan es va crear el lliurament.
        delivered_at:
          type: string
          format: date-time
          nullable: true
          description: Quan es va completar el lliurament, o null.
        detail_lines:
          type: array
          items:
            type: string
          description: >-
            Tipus de missatge i estat d'entrega, en format llegible. No mostra
            els payloads de transport ni els errors en brut.
      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: >-
        La clau d'API de la teva aplicació, des de Developers -> API keys a la
        Business Console. La clau primària té accés complet. Una clau amb nom
        pot tenir l'abast limitat: cap, lectura o escriptura per recurs,
        limitada a determinats fluxos de treball o a sessions aprovades, a una
        llista d'adreces IP i a una data de caducitat. 401 significa que la clau
        és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap
        clau, que la clau no té accés a aquest recurs o acció, o que la
        sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una
        ruta de sessió significa que la sessió està fora dels fluxos de treball
        o estats de la clau. Una clau sense accés a fitxers multimèdia rep els
        URL d'imatge, vídeo i PDF com a null, i una clau sense permís
        d'escriptura de sessions rep els enllaços de sessió i els tokens com a
        null. Consulta https://docs.didit.me/console/api-keys.

````

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