List your accounts
Lists your accounts, newest first. Use it to find your card account with account_type=card&status=active, and your business's own customer ID on the account whose category is main. Filters combine with AND.
Query Parameters
Number of items per page, up to 100
Page number, from 1
Filter by customer
Filter by status
Possible values: active, pending, frozen, deleted, manual_review
Filter by account type, such as regular or card
Responses
| Status | Description |
|---|---|
200 |
List of accounts |
400 |
The request failed. These account routes return every error as HTTP 400, including not found. Read the error message for the cause. |
200 response
Type of account.
Possible values: regular, savings, card, auto_sweep, collection, default, non_custodial
What the account can do. It depends on the account type.
Possible values: transfer, receive, remittance, card_payment, sweep_collection
pending while the bank sets the account up, then active. frozen means suspended or set-up failed, manual_review means held for review, and deleted is closed and final. reason explains a status other than active.
Possible values: active, pending, frozen, manual_review, deleted
Why the account is not active. Omitted for active accounts.
main for your own accounts, sub_account for your customers' accounts.
Possible values: main, sub_account
Balance as a decimal string in major units. For USD it is the USDC balance. For EUR it is that balance converted to EUR. For NGN it is the token balance. For other currencies it is the USDC amount, not converted. The API omits it when it cannot read the balance, so treat a missing value as unknown, not zero.
True for NGN accounts
Set for NGN accounts only
Possible values: settle, auto_onramp
The token wallet of an NGN account
Deposit account number. The US account number for USD, the IBAN for EUR, the account number for GBP, the CLABE for MXN and the BR code for BRL. Bank details appear only once the account is active.
The ABA routing number for USD, the BIC for EUR and the sort code for GBP.
Balance per token
The number of items on this page, not the page size you asked for.
Omitted when there are no matching accounts.
400 response
Human-readable error message.
Authorization
- ApiKeyAuth