Get Whitelisted Addresses

Retrieve a list of whitelisted addresses associated with the account, both fiat and crypto.

Auth:Bearer <api_key>

Tags:Addresses

Request

cURL

curl -G https://publicapi.sandbox.hercle.financial/api/v1/addresses/whitelisted \
  -H "Authorization: Bearer eyJhb..." \

Headers

Name	Type	Required	Description
Authorization	string	Yes	Bearer token for authentication

Response

Success Response Schema

A list of whitelisted addresses.

Field	Type	Description
`id`	string	Unique identifier for the address
`name`	string	User-defined name for the address
`userId`	string	ID of the user who owns the address
`asset`	string	Asset code (e.g., BTC, ETH, USD)
`address`	string	The whitelisted address
`addressParams`	object	Additional address parameters
`network`	string	Network name (e.g., Bitcoin, Ethereum)
`status`	number	Current status of the address `0`→ Pending `1`→ Refused `2`→ Approved `3`→ Deleted
`comment`	string	Comment or note about the address
`auditBy`	string	The auditor who reviewed the address
`endUserId`	string	End user ID associated with the whitelisted address
`auditDate`	string	ISO 8601 timestamp of when the address was audited
`enabled`	boolean	Whether the address is currently enabled for use
`deleted`	boolean	Whether the address has been marked as deleted
`creationDate`	string	ISO 8601 timestamp of when the address was created

Responses

A list of whitelisted addresses.

200 application/json

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "My Whitelisted Address",
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "asset": "BTC",
    "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
    "addressParams": {
      "tag": "123456",
      "hostedby": "VASP"
    },
    "network": "Bitcoin",
    "status": 2,
    "comment": "Primary BTC wallet",
    "endUserId": "enduser-123",
    "auditBy": "admin_user",
    "auditDate": "2025-10-01T12:34:56Z",
    "enabled": true,
    "deleted": false,
    "creationDate": "2025-09-15T08:00:00Z"
  },
  {
    "id": "987e6543-e21b-12d3-a456-426614174001",
    "name": "My Second Address",
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "asset": "ETH",
    "address": "0x32Be343B94f860124dC4fEe278FDCBD38C102D88",
    "addressParams": {},
    "network": "Ethereum",
    "status": 1,
    "comment": "Secondary ETH wallet",
    "endUserId": "enduser-456",
    "auditBy": "admin_user",
    "auditDate": "2025-10-02T09:15:30Z",
    "enabled": false,
    "deleted": false,
    "creationDate": "2025-09-20T10:30:00Z"
  }
]

API Tester

Test this endpoint directly against the sandbox environment

API Key

Get your API key from Hercle Sandbox

Request URL

https://publicapi.sandbox.hercle.financial/api/v1/addresses/whitelisted