Skip to main content
GET
Get Account
Returns one account with its identity details and a balance snapshot. Requires an API key with read access on the accounts scope.

Path Parameters

string
required
The customer’s external ID (starts with cus_). The account is looked up by account_id alone, so this segment does not narrow the lookup: an account you own is returned whichever of your customer IDs is in the path.
string
required
The account’s external ID (starts with acct_)

Response

string
Account identifier (starts with acct_)
string
Always returns "account"
string
External ID of the customer that owns the account
string
The account name
string
Account status: active, suspended, or deactivated
Legal name used as the originator on payments out of this account, or null when the account has no override
string
Registration number used on the originator record, or null
object
Originator address, or null. Fields: address_line, city, region, postal_code, country.
string
Identity type of the end customer behind the account: business, individual, or null when no identity has been recorded
object
Full identity profile recorded for the account, or null. Its shape follows type: a business profile carries the registered entity details, an individual profile the person’s details.
array
Balances for the currencies the account is configured for: a currency enabled for payin, enabled for payout, or on one side of an active FX instrument. A currency the account holds no configuration for is not returned even when its balance is zero. Sorted by updated_at, most recently updated first.
string
ISO 8601 timestamp when created
string
ISO 8601 timestamp when last updated, or null
string
Actor that created the account, for example the API key that called the create endpoint (ak_…), or null
string
Actor that last updated the account, or null

Errors

Response Example