Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

Overview

Use this method to retrieve a wallet record from the Wallet Address Book (WAB).

Request example

curl -X GET \
     'https://api.sumsub.com/resources/api/tr/walletAddress?value=sfsdfsdfsfsdfdsfds' \
     -H 'X-App-Token: <your-app-token>' \
     -H 'X-App-Access-Sig: <your-signature>' \
     -H 'X-App-Access-Ts: <unix-timestamp>'

Response explained

The response is a JSON object that represents the wallet address data retrieved from the WAB.

Field	Type	Description
`walletAddressHash`	String	Wallet address hash.
`walletAddress`	String	Wallet address.
`createdAt`	Date	Date and time the wallet address record was created in the WAB (for example, `2026-05-12 09:28:35+0000`).
`source`	String (Enum)	The source the record was retrieved from. `api` — imported via the API. `dashboard` — added through the Dashboard. `snsConfirmation` — added when a Sumsub client confirmed wallet ownership through the SNS protocol. `applicantPaymentsApi` — added when a Sumsub client created a `cryptoWallet` payment method via the Applicant Payments API. `vaspLookup` — retrieved from a VASP. `applicantData` — retrieved from applicant data.

Response examples

If the request is successfully sent and processed, you will get a response like the following:

{
  "walletAddressHash": "/x4bC/jRwDYK0IUhkBAjDb52qzokxgn6J8hxVOOxtO8=",
  "walletAddress": "sfsdfsdfsfsdfdsfds",
  "createdAt": "2026-05-12 09:28:35+0000",
  "source": "dashboard"
}

If the request fails, you will receive an HTTP response containing an error code along with a message explaining the error. For example:

{
  "code": 400,
  "description": "Human-readable description",
  "correlationId": "0d3457fdac54803edf23c90000000000"
}