Skip to navigation

List Accounts

List every account registered to the authenticated organization. An account is either a bank account (fiat source/destination) or a blockchain wallet (on-chain source/destination); both appear in the same paginated list, distinguished by the kind discriminator.

Wallet accounts carry a networks array, one entry per network, each with its entitlements and their status (see Wallet entitlements). Bank accounts return the full accountNumber alongside routingNumber, bankName, and the beneficiary name on the wire.

Narrow the list with kind, network, and a createdAt range; every filter you send must hold (see Filtering list endpoints). network matches wallets only, so pairing it with kind=bank returns an empty page.

Authentication

AuthorizationBearer

Session JWT from POST /v0/auth/token, sent as Authorization: Bearer <sessionJwt>.

See Authentication for more details.

Query parameters

cursorstringOptional

Opaque pagination cursor. Pass the nextCursor from the previous response; omit to fetch the first page.

limitintegerOptional1-200Defaults to 50

Page size. Defaults to 50; capped at 200.

createdAt.gtdatetimeOptional

Exclusive lower bound on when the account was added, as an ISO-8601 timestamp.

createdAt.gtedatetimeOptional

Inclusive lower bound on when the account was added, as an ISO-8601 timestamp.

createdAt.ltdatetimeOptional

Exclusive upper bound on when the account was added, as an ISO-8601 timestamp. Pairs with createdAt.gte to select a period without depending on its last instant.

createdAt.ltedatetimeOptional

Inclusive upper bound on when the account was added, as an ISO-8601 timestamp.

kindenumOptional
Return only accounts of this kind.
Allowed values:
networklist of enumsOptional

Return only wallets registered on any of these networks, comma-separated. Registration is independent of entitlement state, so a wallet whose entitlement on a network was rejected or removed still matches; read networks[].entitlements for the current state. Bank accounts carry no network and are never matched by this filter.

Allowed values:

Response

OK
datalist of objects

Page of accounts, newest first, tie-broken by id.

nextCursorstring or null

Opaque cursor for the next page. Pass back verbatim as the cursor query param to fetch the next page; null when no more results.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error