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

# Elenco dei messaggi Travel Rule API

> Leggi con Didit i messaggi e le richieste di documenti scambiati con la VASP controparte per un trasferimento Travel Rule.

Prompt dell'API per l'elenco dei messaggi Travel Rule
Copia il prompt negli appunti

<pre>
  \`Read the messages and document requests exchanged with the counterparty VASP about one Travel Rule transfer.

  Endpoint:
  GET [https://verification.didit.me/v3/transactions/\{transaction\_id}/travel-rule/messages/](https://verification.didit.me/v3/transactions/\{transaction_id}/travel-rule/messages/)

  Authentication:
  Use the x-api-key header with my Didit API key. {transaction_id} is the Didit transaction uuid on my application.

  What to read from the response:

  * A plain array, oldest first. Each message has id, kind (MESSAGE or DOCUMENT\_REQUEST), direction (OUTBOUND is what my side sent), author, body, requested\_documents, reply\_to, fulfilled\_at (set once a reply carries a document), attachment and created\_at.
  * attachment.files\[].file\_url is a time-limited download URL.

  Failure modes:

  * 404 - unknown transaction, or no Travel Rule transfer on it.

  Send one with POST on the same path. No webhook fires when the counterparty writes, so read this endpoint.

  Full guide: /transaction-monitoring/travel-rule#messages-and-document-requests.\`
</pre>

Incolla in


## OpenAPI

````yaml it/openapi-25.json GET /v3/transactions/{transaction_id}/travel-rule/messages/
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/messages/:
    get:
      tags:
        - Travel Rule
      summary: Elenca i messaggi Travel Rule
      description: >-
        Messaggi e richieste di documenti scambiati con il VASP di controparte
        in merito a questo trasferimento.
      operationId: listTravelRuleMessages
      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
      responses:
        '200':
          description: I messaggi, dai meno recenti ai più recenti.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TravelRuleMessage'
        '404':
          description: >-
            Transazione o token sconosciuti, oppure nessun trasferimento Travel
            Rule presente nella transazione.
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X GET
            https://verification.didit.me/v3/transactions/{transaction_id}/travel-rule/messages/
            \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.transactions.travel_rule.list_messages(
                "11111111-2222-3333-4444-555555555555",
            )
            print(result)
        - lang: javascript
          label: Node.js
          source: >-
            import Didit from "@didit-protocol/sdk-node";


            // Reads DIDIT_API_KEY.

            const didit = new Didit();


            const result = await
            didit.transactions.travelRule.listMessages("11111111-2222-3333-4444-555555555555");

            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Transactions.TravelRule.ListMessages(ctx, \"11111111-2222-3333-4444-555555555555\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: >-
            import me.didit.Didit;


            // Reads DIDIT_API_KEY.

            Didit client = new Didit();


            var result =
            client.transactions().travelRule().listMessages("11111111-2222-3333-4444-555555555555");

            System.out.println(result);
        - lang: php
          label: PHP
          source: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $result =
            $didit->transactions->travelRule->listMessages('11111111-2222-3333-4444-555555555555');

            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: >-
            require "didit"


            # Reads DIDIT_API_KEY.

            didit = Didit::Client.new


            didit.transactions.travel_rule.list_messages("11111111-2222-3333-4444-555555555555").each
            do |item|
              puts item.to_h
            end
        - lang: csharp
          label: .NET
          source: >-
            using System;

            using System.Text.Json;

            using Didit;


            // Reads DIDIT_API_KEY.

            using var client = new DiditClient();


            var result = await
            client.Transactions.TravelRule.ListMessagesAsync("11111111-2222-3333-4444-555555555555");

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    TravelRuleMessage:
      type: object
      properties:
        id:
          type: string
          format: uuid
        kind:
          type: string
          enum:
            - MESSAGE
            - DOCUMENT_REQUEST
        direction:
          type: string
          enum:
            - INBOUND
            - OUTBOUND
          description: >-
            `OUTBOUND` indica ciò che la tua parte ha inviato. Nel portale di
            ritiro la direzione è dal lato della controparte.
        author:
          type: string
          description: >-
            Chi lo ha scritto dalla propria parte: l'email di un utente della
            console o l'etichetta di una chiave API, oppure il nome dell'altro
            VASP.
        body:
          type: string
        requested_documents:
          type: array
          items:
            type: string
          description: >-
            Cosa richiede una DOCUMENT_REQUEST, secondo le parole del
            richiedente.
        reply_to:
          type: string
          format: uuid
          nullable: true
        fulfilled_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Impostato su un DOCUMENT_REQUEST quando una risposta ad esso
            contiene un documento.
        attachment:
          $ref: '#/components/schemas/TravelRuleMessageAttachment'
        created_at:
          type: string
          format: date-time
    TravelRuleMessageAttachment:
      type: object
      nullable: true
      description: >-
        Il documento allegato a un messaggio, archiviato come qualsiasi altro
        documento di transazione.
      properties:
        uuid:
          type: string
          format: uuid
        label:
          type: string
          nullable: true
        note:
          type: string
          nullable: true
        uploaded_by:
          type: string
          nullable: true
          description: >-
            Chi lo ha allegato. Nel portale di ritiro, un file inviato mostra il
            nome del tuo VASP, mai la persona o la chiave API sottostante.
        created_at:
          type: string
          format: date-time
        files:
          type: array
          items:
            type: object
            properties:
              uuid:
                type: string
                format: uuid
              file_url:
                type: string
                nullable: true
                description: URL di download a tempo.
              original_filename:
                type: string
              file_size:
                type: integer
  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.