curl -X GET https://verification.didit.me/v3/travel-rule/wallet-addresses/ \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.travel_rule.wallet_addresses.list():
print(item)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);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.TravelRule.WalletAddresses.ListAutoPaging(ctx, didit.TravelRuleWalletAddressesListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.travelRule().walletAddresses().list()) {
System.out.println(item);
}<?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());
}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
endusing 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));
}{
"count": 123,
"next": "<string>",
"previous": "<string>",
"results": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"address": "<string>",
"chain": "<string>",
"holder_vendor_data": "<string>",
"holder_name": "<string>",
"entity_type": "<string>",
"is_ownership_verified": true,
"created_at": "2023-11-07T05:31:56Z",
"travel_address": "<string>",
"address_hash": "<string>",
"memo": "<string>",
"receiving_travel_address": "<string>",
"ownership_proof": {
"proof_id": "11111111-2222-4333-8444-555555555555",
"method": "MESSAGE_SIGNING",
"status": "VERIFIED",
"failure_reason": "",
"latest_attempt": {
"proof_id": "66666666-7777-4888-8999-000000000000",
"method": "SCREENSHOT",
"status": "REJECTED",
"failure_reason": "REVIEW_REJECTED"
},
"network_eligible": true,
"reuse_status": "VERIFIED"
},
"label": "<string>",
"owner_type": "customer"
}
],
"proof_totals": {
"wallets": 0,
"customer_wallets": 0,
"verified_control_wallets": 0,
"MESSAGE_SIGNING": 0,
"SATOSHI_TEST": 0,
"SCREENSHOT": 0,
"SELF_DECLARATION": 0
}
}List Wallet Addresses API: Travel Rule Address Book
List the wallet address book entries inbound INTERNAL-rail Travel Rule transfers resolve against, with ownership-verification state.
curl -X GET https://verification.didit.me/v3/travel-rule/wallet-addresses/ \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.travel_rule.wallet_addresses.list():
print(item)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);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.TravelRule.WalletAddresses.ListAutoPaging(ctx, didit.TravelRuleWalletAddressesListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.travelRule().walletAddresses().list()) {
System.out.println(item);
}<?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());
}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
endusing 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));
}{
"count": 123,
"next": "<string>",
"previous": "<string>",
"results": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"address": "<string>",
"chain": "<string>",
"holder_vendor_data": "<string>",
"holder_name": "<string>",
"entity_type": "<string>",
"is_ownership_verified": true,
"created_at": "2023-11-07T05:31:56Z",
"travel_address": "<string>",
"address_hash": "<string>",
"memo": "<string>",
"receiving_travel_address": "<string>",
"ownership_proof": {
"proof_id": "11111111-2222-4333-8444-555555555555",
"method": "MESSAGE_SIGNING",
"status": "VERIFIED",
"failure_reason": "",
"latest_attempt": {
"proof_id": "66666666-7777-4888-8999-000000000000",
"method": "SCREENSHOT",
"status": "REJECTED",
"failure_reason": "REVIEW_REJECTED"
},
"network_eligible": true,
"reuse_status": "VERIFIED"
},
"label": "<string>",
"owner_type": "customer"
}
],
"proof_totals": {
"wallets": 0,
"customer_wallets": 0,
"verified_control_wallets": 0,
"MESSAGE_SIGNING": 0,
"SATOSHI_TEST": 0,
"SCREENSHOT": 0,
"SELF_DECLARATION": 0
}
}Ownership proof metadata
Each entry includes read-onlyownership_proof: proof_id, method, status, failure_reason, latest_attempt, network_eligible and reuse_status. Didit selects the most recently verified current proof, or the latest attempt when no current proof exists. A rejected retry does not replace a valid proof: read latest_attempt to see that retry separately. With no proof, proof_id, method, status and latest_attempt are null and failure_reason is empty.
method is MESSAGE_SIGNING, SATOSHI_TEST, SCREENSHOT or SELF_DECLARATION. failure_reason uses the fixed proof failure codes; it never contains raw diagnostic text.
reuse_status | Meaning |
|---|---|
NOT_LINKED | The wallet has no holder_vendor_data. |
OWNERSHIP_CHANGED | The holder changed and no current proof exists. |
VERIFIED | A current proof exists and the wallet is ownership-verified. |
REJECTED | No current proof exists and the latest proof was rejected. |
EXPIRED | No current proof exists and the latest proof expired. |
AWAITING_PROOF | None of the preceding conditions applies. |
network_eligible describes current discoverability on the wallet’s stored chain and memo. It requires a current control proof, a live application with Travel Rule enabled, and a discoverable VASP profile. It does not mean the wallet was used on the network before or guarantee that a future transfer will be accepted. A verified screenshot or self-declaration alone does not establish network eligibility.
Exact totals
The response includesproof_totals over the entire application-scoped set before limit and offset. count is exact and equals proof_totals.wallets.
| Field | What it counts |
|---|---|
wallets | All wallet entries, regardless of owner type. |
customer_wallets | Wallet entries with owner_type: customer. |
verified_control_wallets | Verified customer wallets with a current message-signing or Satoshi-test proof, counting each wallet once. |
MESSAGE_SIGNING, SATOSHI_TEST, SCREENSHOT, SELF_DECLARATION | Verified customer wallets with a current proof of that method. |
Authorizations
Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is wrong, revoked or expired; 403 means no key was sent, the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.
Query Parameters
Response
Paginated wallet address book entries.