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

# API para listar mensajes de Travel Rule

> Con la API de Didit, consulta los mensajes y solicitudes de documentos intercambiados con el VASP contraparte sobre una transferencia de Travel Rule.

Prompt de la API para listar mensajes de Travel Rule
Copiar el prompt al portapapeles

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

Pegar en


## OpenAPI

````yaml es/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 de verificación de identidad. Autentícate con el encabezado x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/transactions/{transaction_id}/travel-rule/messages/:
    get:
      tags:
        - Travel Rule
      summary: Listar mensajes de Travel Rule
      description: >-
        Mensajes y solicitudes de documentos intercambiados con el VASP de la
        contraparte sobre esta transferencia.
      operationId: listTravelRuleMessages
      parameters:
        - name: transaction_id
          in: path
          required: true
          description: >-
            UUID estable de Didit de la transacción a la que pertenece la
            transferencia.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Los mensajes, del más antiguo al más reciente.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TravelRuleMessage'
        '404':
          description: >-
            Transacción o token desconocidos, o la transacción no tiene ninguna
            transferencia de Travel Rule.
      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` es lo que envió el propio lado de quien lee. En el portal
            de recogida, la dirección se considera desde el lado de la
            contraparte.
        author:
          type: string
          description: >-
            Quién lo escribió en su propio lado: el correo electrónico de un
            usuario de la consola o la etiqueta de una clave de API, o el nombre
            del otro VASP.
        body:
          type: string
        requested_documents:
          type: array
          items:
            type: string
          description: Qué pide un DOCUMENT_REQUEST, en palabras del solicitante.
        reply_to:
          type: string
          format: uuid
          nullable: true
        fulfilled_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Se establece en un DOCUMENT_REQUEST cuando una respuesta a esa
            solicitud incluye un documento.
        attachment:
          $ref: '#/components/schemas/TravelRuleMessageAttachment'
        created_at:
          type: string
          format: date-time
    TravelRuleMessageAttachment:
      type: object
      nullable: true
      description: >-
        El documento adjunto a un mensaje, almacenado como cualquier otro
        documento de transacción.
      properties:
        uuid:
          type: string
          format: uuid
        label:
          type: string
          nullable: true
        note:
          type: string
          nullable: true
        uploaded_by:
          type: string
          nullable: true
          description: >-
            Quién lo adjuntó. En el portal de recogida, un archivo que enviaste
            muestra el nombre de tu VASP, nunca la persona ni la clave de API
            que hay detrás.
        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 de descarga de validez limitada.
              original_filename:
                type: string
              file_size:
                type: integer
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        La clave de API de tu aplicación, que encontrarás en Developers -> API
        keys en la Business Console. La clave principal tiene acceso completo.
        Una clave con nombre puede tener un alcance limitado: ninguno, lectura o
        escritura por recurso, limitada a algunos flujos o a sesiones aprobadas,
        a una lista de direcciones IP y a una fecha de caducidad. 401 significa
        que la clave es incorrecta, se revocó o expiró; 403 significa que no se
        envió ninguna clave, que la clave no tiene acceso a este recurso o
        acción, o que la solicitud provino de una dirección fuera de su lista de
        IP; 404 en una ruta de sesión significa que la sesión está fuera de los
        flujos o estados de la clave. Una clave sin acceso a contenido
        multimedia recibe las URL de imágenes, videos y PDF como null, y una
        clave sin permiso de escritura en sesiones recibe los enlaces y tokens
        de sesión como null. Consulta https://docs.didit.me/console/api-keys.

````

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