Skip to navigation

Get an Account by ID

Retrieve one account by its id. The response is identical to that account’s entry in GET /v0/accounts (a wallet with its per-network entitlements, or a bank account with its full accountNumber and beneficiary), so you never need to reconcile the two shapes.

An id belonging to another organization returns 404 account_not_found, the same as an id that exists nowhere. If your API key can read only one account kind, accounts of the other kind read as 404 too; a key that can read neither gets 403.

Authentication

AuthorizationBearer

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

See Authentication for more details.

Path parameters

accountIdstringRequiredformat: "uuid"

Id of the account to fetch; must belong to the caller’s org.

Response

OK
Walletobject

Customer-owned blockchain address (CustomerAddress).

OR
Bank Accountobject

Customer-owned bank account (WireDetail).

Errors

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