> ## 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 de seletor de VASP: busca no diretório Travel Rule

> Busca de VASPs da Didit por token no seletor do widget de carteira: identifica cada VASP e indica se ele pode ser contatado.



Prompt da API de busca de VASPs do widget
        Copiar o prompt para a área de transferência



      
      

\<pre>

\`Search VASPs from a wallet widget session: the VASP picker an end user uses to say which exchange the funds go to.

Endpoint:
GET https://verification.didit.me/v3/travel-rule/widget/{token}/vasps/?search=<term>

Authentication:
None - the widget token in the URL path is the credential. Treat the token as a secret.

Query parameters: the same as GET /v3/travel-rule/vasps/ (search, network, jurisdiction, reachable, kind, limit, offset), answered for the widget's application.

What to read from each result:
\- id, kind, name, lei, jurisdiction, domains - who the VASP is.
\- reachable - whether the application can deliver Travel Rule data to it today.
Routes, contacts and due-diligence fields are not shown to the end user.

Failure modes:
\- 400 - an unknown network or country code.
\- 404 - unknown token.
\- 410 - the session expired.

Full guide: /transaction-monitoring/travel-rule#directory.`

\</pre>



      
      

Colar em



## OpenAPI

````yaml pt-br/openapi-25.json GET /v3/travel-rule/widget/{token}/vasps/
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/widget/{token}/vasps/:
    get:
      tags:
        - Travel Rule
      summary: Pesquisar VASPs a partir do widget de carteira
      description: >-
        Endpoint público de leitura identificado pelo token de sessão do widget,
        sem necessidade de chave de API: o seletor de VASP do widget do usuário
        final. Mesma busca e mesmos filtros de GET /v3/travel-rule/vasps/ para a
        aplicação do widget, informando apenas quem é cada VASP e se ele pode
        ser contatado.
      operationId: listTravelRuleWidgetVasps
      parameters:
        - name: token
          in: path
          required: true
          description: >-
            Token de sessão opaco retornado quando a sessão do widget foi
            criada.
          schema:
            type: string
        - name: search
          in: query
          schema:
            type: string
            maxLength: 255
          description: >-
            Um fragmento de nome ou alias (sem diferenciar maiúsculas de
            minúsculas), um LEI exato ou um domínio (example.com ou uma URL
            nesse domínio). Membros da rede Didit correspondem pelo nome legal,
            pelo LEI ou pelo domínio do seu e-mail de conformidade.
        - name: network
          in: query
          schema:
            type: string
            enum:
              - GTR
              - TRUST
              - VERIFYVASP
              - SYGNA
              - TRISA
          description: >-
            Somente entradas do diretório que o diretório de membros de uma rede
            lista atualmente.
        - name: jurisdiction
          in: query
          schema:
            type: string
          description: >-
            Código de país ISO 3166 alpha-2 ou alpha-3. Qualquer outro valor
            retorna 400.
        - name: reachable
          in: query
          schema:
            type: boolean
          description: >-
            true: apenas VASPs para os quais sua aplicação tem uma rota
            disponível (incluindo membros da rede Didit). false: apenas entradas
            do diretório que ela não consegue alcançar hoje.
        - name: kind
          in: query
          schema:
            type: string
            enum:
              - directory
              - didit
          description: Somente entradas do diretório, ou somente membros da rede Didit.
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
            minimum: 1
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
            minimum: 0
      responses:
        '200':
          description: Resultados paginados, ordenados por nome.
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                  next:
                    type: string
                    nullable: true
                  previous:
                    type: string
                    nullable: true
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/VaspDirectoryWidgetEntry'
        '400':
          description: >-
            Um filtro não é válido: o corpo nomeia cada campo, por exemplo, uma
            rede ou um código de país desconhecido.
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: array
                  items:
                    type: string
              example:
                jurisdiction:
                  - Use an ISO 3166 alpha-2 or alpha-3 country code.
                network:
                  - '"SWIFT" is not a valid choice.'
        '404':
          description: Token desconhecido.
        '410':
          description: A sessão expirou.
      security:
        - {}
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl
            'https://verification.didit.me/v3/travel-rule/widget/{token}/vasps/?search=counterparty'
components:
  schemas:
    VaspDirectoryWidgetEntry:
      type: object
      description: >-
        O que o seletor de VASP do usuário final exibe: quem é o VASP e se ele
        pode ser contatado.
      properties:
        id:
          type: string
          format: uuid
          description: O id da entrada, para GET /v3/travel-rule/vasps/{vasp_id}/.
        kind:
          type: string
          enum:
            - directory
            - didit
          description: >-
            directory para uma entrada do diretório compartilhado; didit para um
            membro da rede Didit.
        name:
          type: string
        lei:
          type: string
        jurisdiction:
          type: string
          description: Código de país ISO 3166, conforme informado pela fonte.
        domains:
          type: array
          items:
            type: string
          description: Os domínios web do VASP. Sempre vazio para membros da rede Didit.
        reachable:
          type: boolean
          description: >-
            Se a sua aplicação tem uma rota disponível até este VASP ou, no caso
            de uma marca, até uma de suas entidades. Sempre true para um membro
            da rede Didit.

````

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