List Whitelisted Wallets
List the wallets whitelisted for deposits into and withdrawals from the balance, newest first. Cursor-paginated: pass next_page_token as page_token for the next page.
X-Api-Key<token>API key in format: sti_env_prefix_secret
page_size?integer1 <= value <= 10020page_token?stringOpaque cursor from the previous page's next_page_token.
status?stringFilter to one status. Archived wallets are only returned when status=archived.
"pending_review""active""rejected""deactivated""archived"network?stringFilter to one network; omit to include every network.
"ethereum""polygon""solana""tron"Default Response
application/json- response
data*array<>has_more*booleannext_page_token?stringcurl -X GET 'https://api.sandbox.stables.money/api/v1/prefund/whitelisted-wallets'{ "data": [ { "id": "string", "name": "string", "network": "ethereum", "address": "string", "status": "pending_review", "rejection_reason": "string", "created_at": "string", "updated_at": "string" } ], "has_more": true, "next_page_token": "string"}Returns the wallets you have whitelisted for deposits into and withdrawals from your balance, newest first. Only wallets with status active can deposit or receive withdrawals. Archived wallets are left out unless you pass status=archived.
Results are cursor-paginated. Pass next_page_token as page_token on the next request. See Pagination.
Response fields
| Field | Description |
|---|---|
name | The label given when it was whitelisted. |
status | One of pending_review, active, rejected, deactivated, archived. See the Balances guide. |
rejection_reason | Why Stables declined it. null unless status is rejected. |
Whitelisting a wallet is done in the dashboard. There is no endpoint to add one.
Whitelisting is enabled per organisation. If this endpoint returns 404, it is not switched on for your account. Contact your Stables representative.
Related: Balances in the Developer Platform guide covers whitelisting, topping up and withdrawing.