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

# Listar mensagens de retirada: API Travel Rule por e-mail

> Use a API da Didit para ler as mensagens de uma transferência Travel Rule por e-mail, pelo lado da VASP contraparte no link de retirada.

Prompt da API de listagem de mensagens para retirada
Copiar o prompt para a área de transferência

<pre>
  \`Read the messages of an EMAIL-rail Travel Rule transfer as the counterparty VASP sees them.

  Endpoint:
  GET [https://verification.didit.me/v3/travel-rule/pickup/\{token}/messages/](https://verification.didit.me/v3/travel-rule/pickup/\{token}/messages/)

  Authentication:
  None - the one-time pickup link token is the credential.

  What to read from the response:

  * A plain array, oldest first, from the counterparty's side: what the customer sent has direction INBOUND and its author is the customer's VASP name.

  Failure modes:

  * 404 - unknown token.
  * 410 - the pickup link expired or the transfer is closed.

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

Colar em


## OpenAPI

````yaml pt-br/openapi-25.json GET /v3/travel-rule/pickup/{token}/messages/
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/travel-rule/pickup/{token}/messages/:
    get:
      tags:
        - Travel Rule
      summary: Listar mensagens para coleta
      description: >-
        Público, sem autenticação. As mensagens de uma transferência pelo canal
        EMAIL como o VASP contraparte as lê: o que o cliente enviou é `INBOUND`
        e é assinado com o nome do VASP do cliente. O token é a autenticação.
      operationId: listTravelRulePickupMessages
      parameters:
        - name: token
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: >-
            As mensagens, da mais antiga para a mais recente, do lado da
            contraparte.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TravelRuleMessage'
        '404':
          description: Token desconhecido.
        '410':
          description: O link de retirada expirou ou a transferência está encerrada.
      security:
        - {}
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl
            https://verification.didit.me/v3/travel-rule/pickup/{token}/messages/
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` é o que o próprio lado do leitor enviou. No portal de
            retirada, a direção é a partir do lado da contraparte.
        author:
          type: string
          description: >-
            Quem o escreveu do próprio lado: o e-mail de um usuário do console
            ou o rótulo de uma chave de API, ou o nome do outro VASP.
        body:
          type: string
        requested_documents:
          type: array
          items:
            type: string
          description: O que um DOCUMENT_REQUEST solicita, nas palavras do solicitante.
        reply_to:
          type: string
          format: uuid
          nullable: true
        fulfilled_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Definido em um DOCUMENT_REQUEST assim que uma resposta a ele contém
            um documento.
        attachment:
          $ref: '#/components/schemas/TravelRuleMessageAttachment'
        created_at:
          type: string
          format: date-time
    TravelRuleMessageAttachment:
      type: object
      nullable: true
      description: >-
        O documento anexado a uma mensagem, armazenado como qualquer outro
        documento de transação.
      properties:
        uuid:
          type: string
          format: uuid
        label:
          type: string
          nullable: true
        note:
          type: string
          nullable: true
        uploaded_by:
          type: string
          nullable: true
          description: >-
            Quem o anexou. No portal de retirada, um arquivo que você enviou
            mostra o nome do seu VASP, nunca a pessoa ou a chave de API por trás
            dele.
        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 download com tempo limitado.
              original_filename:
                type: string
              file_size:
                type: integer

````

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