Get account by id
Returns a single account for the caller workspace. Balances are filtered by the workspace’s token whitelist by default; pass show_all=true to restore the unfiltered response.
Authorizations
Authorization method required to allow user to access the api endpoints.
Path Parameters
Query Parameters
Restores the response to today's unfiltered shape, byte-for-byte, ignoring the workspace token whitelist. Never mutates stored overrides.
Response
Stable account id. Matches account_id on workspace balance responses for joins.
"bje5mmbqxjvwjaf7oxwpyxntxdyspzZyt4vwennw5rug"
eoa, multisig, contract, custodian, exchange, bank, defi "eoa"
"ledger, kraken, wallet, ..."
active, updating "active"
Null when the account was saved without a name.
"Treasury wallet"
"solana"
"BJE5MMbqXjVwjAF7oxwPYXnTXDyspzZyt4vwenNw5ruG"
Total USD value across all of the account balances. null when no asset has a known price.
"1234.56"
"2024-01-01T00:00:00.000Z"
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
"Primary treasury wallet"
"Treasury"
When a transaction-sync run last succeeded for this account, or null if none ever has. Always present on persisted account responses; omitted on connection-preview stubs that have never been imported. Sync is only triggered manually via POST /v2/accounts/transfers/sync (one job per account).
"2026-01-01T00:00:00.000Z"
Why the most recent transaction sync failed, when the cause is permanent for this account rather than a transient error worth retrying. Classified from ops-only last_sync_error; never the raw text.
provider_region_unsupported: the provider does not serve transaction history for this account's country with the credential it was given. Always present on persisted account responses; omitted on preview stubs.
provider_region_unsupported "provider_region_unsupported"
Outcome of the most recent sync run for this account, or null before the first one. failed leaves last_synced_at at the last genuinely successful run. Always present on persisted account responses; omitted on preview stubs.
running, succeeded, failed "succeeded"
When the most recent balance-refresh attempt ran, or null before the first one. Advances on every attempt including a failed one — unlike balances_updated_at, which only moves on a successful read, so a client can tell "stale because nobody asked" from "stale because it keeps failing". Always present on persisted account responses; omitted on connection-preview stubs that have never been imported.
"2026-01-01T00:00:00.000Z"
Why the most recent balance-refresh attempt failed, as a stable machine code a client may branch on without string-matching prose that may be reworded. null when the last attempt succeeded, none has been made yet, or the chain has no readable balance source. Always present on persisted account responses; omitted on preview stubs.
reconnect_required, provider_timeout, rate_limited, authentication_failed, provider_unreachable, provider_rejected, provider_error, connection_not_found, balance_lookup_failed, unclassified_provider_error "provider_timeout"
Outcome of the most recent balance-refresh attempt for this account. unsupported means this chain has no readable balance source — derived, and takes precedence over any stored status. null before the first attempt. Distinct from sync_status, which tracks transaction-history sync, not balances. Always present on persisted account responses; omitted on connection-preview stubs that have never been imported.
succeeded, failed, unsupported "succeeded"