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

# Cronologia delle consegne Travel Rule: riferimento API

> Leggi la cronologia completa delle consegne Travel Rule di Didit per una transazione: paginazione, tipi di trasporto, stato e timestamp.

Prompt dell'API della cronologia delle consegne Travel Rule
Copia il prompt negli appunti

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

Incolla in

L'API della cronologia delle consegne Travel Rule di Didit restituisce tutte le voci di consegna relative a una transazione, suddivise in pagine, dalla più vecchia alla più recente.

Usa la tua `x-api-key` con l'autorizzazione di lettura delle transazioni. `transaction_id` è l'UUID della transazione Didit. Una transazione o un trasferimento mancante restituisce `404`; un'autorizzazione insufficiente restituisce `403`.

## Paginazione e ordinamento

La risposta contiene `count`, `next`, `previous` e `results`. `limit` ha come valore predefinito 100 ed è limitato a 100; `offset` ha come valore predefinito zero e non deve superare 1.000.000, altrimenti restituisce `400`. `count` è di norma limitato a 100 e non è un totale affidabile per cronologie più estese. Segui `next` finché non è `null`, indipendentemente da `count`. Le voci sono ordinate per ora di creazione e, in caso di parità, per identificatore.

Ogni voce contiene `uuid`, `kind`, `status`, `rail`, `created_at`, `delivered_at` e `detail_lines`. `rail` è `EMAIL`, `TRP`, `INTERNAL`, `NETWORK` oppure `null` prima della selezione. `detail_lines` descrive il tipo di messaggio e lo stato senza errori non elaborati né payload di trasporto.

## Cronologia incorporata

[Dettaglio transazione](https://docs.didit.me/it/management-api/transactions/get.md) include solo le ultime 100 voci in `travel_rule.deliveries`, presentate dalla più vecchia alla più recente. `deliveries_truncated` indica se sono state omesse voci più vecchie. Le liste delle transazioni omettono questi due campi della cronologia. Il campo esistente `delivery` continua a descrivere l'ultima consegna.

Per il significato degli stati, consulta [consegna e nuovi tentativi](https://docs.didit.me/it/transaction-monitoring/travel-rule.md#consegna-e-nuovi-tentativi). [Messaggi della controparte](https://docs.didit.me/it/management-api/travel-rule/list-messages.md) sono un endpoint separato dedicato alla conversazione.


## OpenAPI

````yaml it/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 di verifica dell'identità. Autenticati con l'intestazione x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/transactions/{transaction_id}/travel-rule/deliveries/:
    get:
      tags:
        - Travel Rule
      summary: Elenca la cronologia delle consegne della Travel Rule
      description: >-
        Leggi la cronologia completa delle consegne di una transazione, dalla
        più vecchia alla più recente. Richiede il permesso di lettura sulle
        transazioni. A differenza delle ultime 100 voci incluse nel dettaglio,
        questo endpoint pagina l'intera cronologia. Vedi [cronologia delle
        consegne](/it/management-api/travel-rule/list-deliveries).
      operationId: listTravelRuleDeliveries
      parameters:
        - name: transaction_id
          in: path
          required: true
          description: >-
            UUID della transazione stabile di Didit a cui appartiene il
            trasferimento.
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 1000000
            default: 100
          description: >-
            Voci per pagina. Il valore predefinito è 100 e i valori più grandi
            sono limitati a 100; un valore superiore a 1.000.000 restituisce
            `400`.
        - name: offset
          in: query
          schema:
            type: integer
            maximum: 1000000
            minimum: 0
            default: 0
          description: >-
            Numero di voci da saltare, fino a 1.000.000. Un valore più alto
            restituisce `400`.
      responses:
        '200':
          description: >-
            Cronologia paginata delle consegne, dalla più vecchia alla più
            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: È stato inviato un `limit` o un `offset` superiore a 1.000.000.
        '401':
          description: Una chiave API errata, revocata o scaduta.
        '403':
          description: >-
            Chiave API mancante, non valida o revocata, oppure la chiave non può
            leggere le transazioni di questa applicazione. Una chiave mancante
            restituisce `403`; una chiave errata, revocata o scaduta restituisce
            `401`.
        '404':
          description: Transazione o trasferimento Travel Rule non trovato.
      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: >-
            Conteggio normalmente limitato a 100; non è un totale affidabile per
            cronologie più lunghe. Segui next finché non è null,
            indipendentemente da count.
        next:
          type: string
          format: uri
          nullable: true
          description: URL della pagina successiva, oppure null.
        previous:
          type: string
          format: uri
          nullable: true
          description: URL della pagina precedente, o null.
        results:
          type: array
          items:
            $ref: '#/components/schemas/TravelRuleDeliveryLogEntry'
          description: >-
            Voci ordinate dalla più vecchia alla più recente per data di
            creazione, quindi per identificativo.
    TravelRuleDeliveryLogEntry:
      type: object
      description: Una voce della cronologia delle consegne, indipendente dal fornitore.
      required:
        - uuid
        - kind
        - status
        - rail
        - created_at
        - delivered_at
        - detail_lines
      properties:
        uuid:
          type: string
          format: uuid
          description: Identificativo della consegna.
        kind:
          type: string
          enum:
            - SEND
            - ANSWER
            - TXID
            - CANCEL
            - POLL
          description: >-
            Cosa trasporta il messaggio. `SEND`: il primo messaggio del
            trasferimento verso la controparte (in uscita; il canale viene
            scelto al momento dell'invio). `ANSWER`: la tua accettazione o
            rifiuto, dovuta alla rete che ha effettuato la richiesta (in
            entrata). `TXID`: l'hash della transazione on-chain, dopo aver
            completato il trasferimento. `CANCEL`: l'annullamento, dopo averlo
            cancellato. `POLL`: una richiesta di stato verso una rete che la
            supporta, ripetuta ogni 5 minuti mentre il trasferimento è in attesa
            della controparte.
        status:
          type: string
          enum:
            - QUEUED
            - SENDING
            - RETRYING
            - DELIVERED
            - FAILED
          description: Stato di consegna attuale.
        rail:
          type: string
          nullable: true
          enum:
            - EMAIL
            - TRP
            - INTERNAL
            - NETWORK
            - null
          description: >-
            Tipo di trasporto indipendente dal fornitore; null finché non viene
            selezionato.
        created_at:
          type: string
          format: date-time
          description: Data e ora di creazione della consegna.
        delivered_at:
          type: string
          format: date-time
          nullable: true
          description: Quando la consegna è stata completata, oppure null.
        detail_lines:
          type: array
          items:
            type: string
          description: >-
            Tipo di messaggio in formato leggibile e stato della consegna. Non
            espone payload di trasporto né errori grezzi.
      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 chiave API della tua applicazione, da Developers -> API keys nella
        Business Console. La chiave primaria ha accesso completo. Una chiave con
        nome può avere un ambito definito: nessuno, lettura o scrittura per
        risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco
        di indirizzi IP e a una data di scadenza. 401 indica che la chiave è
        errata, revocata o scaduta; 403 indica che non è stata inviata alcuna
        chiave, che la chiave non ha accesso a questa risorsa o azione, oppure
        che la richiesta proviene da un indirizzo non incluso nel suo elenco IP;
        404 su una route di sessione indica che la sessione non rientra nei
        workflow o negli stati previsti dalla chiave. Una chiave senza accesso
        ai media riceve gli URL di immagini, video e PDF come null, e una chiave
        senza permessi di scrittura sulle sessioni riceve link e token di
        sessione come null. Consulta https://docs.didit.me/console/api-keys.

````

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