Skip to main content
GET
Fetch wallets
Retrieves a list of all wallets associated with your merchant account.

Key Features:

  • Returns both STABLECOIN and FIAT wallets
  • Supports filtering by status, asset_type, currency, and customer_id
  • Includes pagination metadata

Query Parameters:

  • page: Page number (default: 1)
  • limit: Items per page (default: 10)
  • status: Filter by status (active/pending/suspended)
  • asset_type: Filter by type (STABLECOIN/FIAT)
  • currency: Filter by currency (USDC, USDT, etc.)
  • customer_id: Filter by customer ID

Response Examples:

Success Response:

Headers

x-api-key
string
required

Query Parameters

customer_id
string<uuid>
status
enum<string>
Available options:
active
asset_type
enum<string>
Available options:
STABLECOIN,
FIAT
currency
enum<string>
Available options:
USDC,
ZAR
page
integer
Required range: x >= 1
limit
integer
Required range: 1 <= x <= 100

Response

200 - application/json

Wallets retrieved successfully

status
string
Example:

"success"

data
object[]
pagination
object