> ## 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 per llistar adreces de cartera de Travel Rule

> Llista les adreces de cartera de Didit que resolen les transferències INTERNAL de Travel Rule, amb l'estat de verificació de titularitat.

Prompt de l'API per llistar adreces de carteres
Copia el prompt al porta-retalls

<pre>
  \`List the application's Travel Rule wallet address book - the registry of wallets you control that inbound INTERNAL-rail transfers resolve against.

  Endpoint:
  GET [https://verification.didit.me/v3/travel-rule/wallet-addresses/](https://verification.didit.me/v3/travel-rule/wallet-addresses/)

  Authentication:
  Use the x-api-key header with my Didit API key.

  Query parameters:

  * limit / offset - pagination; count/next/previous describe the page window.

  What to read from each entry:

  * uuid - the entry id, used in PATCH/DELETE /v3/travel-rule/wallet-addresses/{entry_uuid}/.
  * address, chain - the registered wallet.
    When a transfer names a chain, sunrise registration, the INTERNAL rail and the outbound TRP travel-address lookup match an entry only when its chain equals the transfer's chain (case-insensitive) or the entry's chain is blank.
    Chain names are not translated, so an entry with chain "ethereum" does not match a transfer with chain "ETH".
    Inbound TRP inquiries and ownership confirmation ignore the chain and match by address (an inbound TRP inquiry that carries no address matches a verified entry by holder\_name instead).
  * holder\_name / holder\_vendor\_data / entity\_type - the wallet holder, used for the beneficiary name match.
  * travel\_address - the counterparty VASP's travel address for this wallet, when known; it lets outbound transfers of an asset TRP carries (BTC, ETH, and USDC on a named network) to this wallet route over TRP.
  * is\_ownership\_verified - whether control of this address has been proven (wallet-ownership widget or self-declaration). Verified entries let inbound transfers skip UNCONFIRMED\_OWNERSHIP.

  Full guide: /transaction-monitoring/travel-rule#wallet-address-book.\`
</pre>

Enganxa a


## OpenAPI

````yaml ca/openapi-25.json GET /v3/travel-rule/wallet-addresses/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API de verificació d'identitat. Autentica't amb la capçalera x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/travel-rule/wallet-addresses/:
    get:
      tags:
        - Travel Rule
      summary: Llista les entrades de la llibreta d'adreces de carteres
      description: >-
        Llista paginada de la llibreta d'adreces de carteres de la Travel Rule
        de la teva aplicació, les més recents primer.
      operationId: listTravelRuleWalletAddresses
      parameters:
        - 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: Entrades de la llibreta d'adreces de carteres paginades.
          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/WalletAddressEntry'
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X GET
            https://verification.didit.me/v3/travel-rule/wallet-addresses/ \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            for item in client.travel_rule.wallet_addresses.list():
                print(item)
        - lang: javascript
          label: Node.js
          source: |-
            import Didit from "@didit-protocol/sdk-node";

            // Reads DIDIT_API_KEY.
            const didit = new Didit();

            for await (const item of didit.travelRule.walletAddresses.list()) {
              console.log(item);
            }
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.TravelRule.WalletAddresses.ListAutoPaging(ctx, didit.TravelRuleWalletAddressesListParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}"
        - lang: java
          label: Java
          source: |-
            import me.didit.Didit;

            // Reads DIDIT_API_KEY.
            Didit client = new Didit();

            for (var item : client.travelRule().walletAddresses().list()) {
                System.out.println(item);
            }
        - lang: php
          label: PHP
          source: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // Reads DIDIT_API_KEY.
            $didit = new DiditClient();

            foreach ($didit->travelRule->walletAddresses->list() as $item) {
                print_r($item->toArray());
            }
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY.
            didit = Didit::Client.new

            didit.travel_rule.wallet_addresses.list.auto_paging_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();


            await foreach (var item in await
            client.TravelRule.WalletAddresses.ListAsync())

            {
                Console.WriteLine(JsonSerializer.Serialize(item));
            }
components:
  schemas:
    WalletAddressEntry:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        address:
          type: string
          description: >-
            L'adreça de la cartera; `""` per a una entrada importada només pel
            seu resum criptogràfic. Única per aplicació, cadena i memo,
            comparant l'adreça sense distingir majúscules de minúscules. Després
            de suprimir una entrada, pots tornar a registrar la mateixa adreça.
        chain:
          type: string
          description: >-
            Token de cadena per a l'adreça, per exemple `ETH` o `BTC`. Quan
            Didit encamina o registra una transferència, fa coincidir les
            entrades de la llibreta d'adreces amb l'adreça de la cartera i, quan
            la transferència inclou una cadena, també amb aquest valor, ignorant
            majúscules i minúscules. La cadena d'una transferència és
            `beneficiary_data.chain`, que s'omple a partir de la cadena cripto
            de la transacció o del símbol de la moneda (per exemple, `ETH`) quan
            no l'envies, o del camp `chain` d'un registre posterior al dipòsit,
            de manera que has de fer servir el mateix token a tot arreu. Una
            entrada amb una cadena buida coincideix amb qualsevol cadena. Un
            beneficiari de Lightning (un id de node o una Lightning Address)
            registrat a bitcoin s'emmagatzema en minúscules a `LIGHTNING`, on es
            fan coincidir les transferències de Lightning. Les cadenes conegudes
            s'emmagatzemen sota un únic identificador canònic, independentment
            de com s'escriguin: "ethereum", "Ethereum" i "ERC20" s'emmagatzemen
            com a ETH; "BNB Smart Chain" i "BEP20" com a BNB; "tron" com a TRX.
            Els noms de cadena desconeguts es mantenen tal com s'han indicat.
        holder_vendor_data:
          type: string
          description: El teu identificador intern per al titular.
        holder_name:
          type: string
          description: >-
            Nom del titular de la cartera, utilitzat per a la coincidència del
            nom del beneficiari.
        entity_type:
          type: string
          description: Text lliure, per defecte "individual".
        is_ownership_verified:
          type: boolean
          description: >-
            Només de lectura. Indica si s'ha demostrat la titularitat d'aquesta
            adreça.
        created_at:
          type: string
          format: date-time
        travel_address:
          type: string
          description: >-
            La Travel Address del VASP contrapart per a aquesta cartera, si es
            coneix. Permet a Didit encaminar les transferències d'aquest
            beneficiari a través del canal TRP, per als actius que admet TRP
            (BTC, ETH i USDC en una xarxa designada).
        address_hash:
          type: string
          description: >-
            Només de lectura. SHA-256 de l'adreça en minúscules, en format
            hexadecimal en minúscules. Una entrada importada només pel seu hash
            s'hi emparella mitjançant aquest valor.
        memo:
          type: string
          description: >-
            L'etiqueta de destinació o nota que forma part de la cartera en una
            xarxa de notes (XRP, XLM, EOS, ATOM, HBAR); `""` per a tota
            l'adreça. Una entrada amb una nota només coincideix amb
            transferències que indiquin aquesta nota; una sense coincideix amb
            tota l'adreça.
        receiving_travel_address:
          type: string
          readOnly: true
          description: >-
            La teva Travel Address específica per a aquesta cartera:
            proporciona-la al VASP remitent perquè la seva consulta TRP designi
            aquesta cartera. Està buida per a una cartera registrada com a
            pertanyent a un altre VASP, mentre Travel Rule estigui desactivada i
            abans que es desi el teu perfil de VASP.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        La clau d'API de la teva aplicació, des de Developers -> API keys a la
        Business Console. La clau primària té accés complet. Una clau amb nom
        pot tenir l'abast limitat: cap, lectura o escriptura per recurs,
        limitada a determinats fluxos de treball o a sessions aprovades, a una
        llista d'adreces IP i a una data de caducitat. 401 significa que la clau
        és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap
        clau, que la clau no té accés a aquest recurs o acció, o que la
        sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una
        ruta de sessió significa que la sessió està fora dels fluxos de treball
        o estats de la clau. Una clau sense accés a fitxers multimèdia rep els
        URL d'imatge, vídeo i PDF com a null, i una clau sense permís
        d'escriptura de sessions rep els enllaços de sessió i els tokens com a
        null. Consulta https://docs.didit.me/console/api-keys.

````

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