Agora Public APIEndpointsAccounts

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](/api/endpoints/accounts/overview#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](/api#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.

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