v2

latestOpenAPI 3.1.02026-08-0513206146.6 KB
Accounts

List Accounts

<Callout intent="warning"> The endpoints exposed here are currently in **Beta**! As we continue to build our initial offering, these endpoints may implement breaking changes. Be sure to check back for our change log regularly as a precaution. </Callout>

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.

get/v0/accounts

Query parameters

cursorstring

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

limitinteger

Page size. Defaults to 50; capped at 200.

createdAt.gtstring date-time

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

createdAt.gtestring date-time

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

createdAt.ltstring date-time

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.ltestring date-time

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

kind'bank' | 'wallet'

Return only accounts of this kind.

Return only accounts of this kind.

networkV0AccountsGetParametersNetworkSchemaItems[]

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.

Headers

Authorizationstring required

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

See Authentication for more details.

Response

OK

nextCursorstring nullable required

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