Skip to main content
GET
Get an account

Authorizations

Authorization
string
header
required

Bearer token authentication. Pass your API key as Authorization: Bearer sk_.... See Authentication for keys, scopes, and sandbox vs production.

Path Parameters

account_id
string
required

The account to act on. It must be one of your own accounts; any other ID returns 404 so the response never confirms that an unrelated account exists.

Query Parameters

include
enum<string>[]

Expandable blocks to add. requirements.values returns the account's current field values and the per-person rollup, which cost an extra resource load. Comma-separated or repeated; an unknown value returns 400 invalid_include. Anything not asked for is omitted from the response rather than returned as null.

Available options:
requirements.values

Response

The account.

id
string

Unique identifier for the account.

Example:

"acct_7KpQ2mNv4XbR9dLc"

name
string | null

The account's display name.

Example:

"Ada Stores"

owner_user_id
string

The user that owns the account. For an account you own this is a service user Bachs created; you never authenticate as it.

Example:

"usr_7b3e19d24c0a"

parent_organization_id
string | null

The platform this account is connected to, or null when it is a platform in its own right.

Example:

"acct_7KpQ2mNv4XbR9dLc"

country
string | null

Two-letter ISO 3166-1 country code. Decides which requirements the account is given.

Example:

"NG"

entity_type
enum<string> | null

What kind of legal person the account is, which together with country decides the requirements it is given. company: a registered entity, asked for registration and ownership details. individual: a natural person, asked only for their own identity.

Available options:
company,
individual
Example:

"company"

fee_handling
enum<string>

Who absorbs processing fees at checkout. account_pays_fee: deducted from the amount you receive. customer_pays_fee: added to what the customer pays.

Available options:
account_pays_fee,
customer_pays_fee
Example:

"account_pays_fee"

enabled_payment_methods
object | null

One entry per exact corridor (USD_CARD, NGN_CARD, NGN_BANK_TRANSFER, MOMO_GHS to MOMO_ZMW, CRYPTO). See payment method support. Each value has an enabled boolean; CRYPTO additionally carries a currencies map since it covers several asset/network pairs.

adaptive_pricing
boolean

When true, customers are shown prices in their local currency where one is available.

Example:

true

balance_currencies
string[]

Currencies this account is configured to hold a balance in.

Example:
phone_number
string | null

Contact phone number, including country code.

Example:

"+2348012345678"

company_name
string | null

Registered company name, when the account is a company.

Example:

"Ada Stores Limited"

enabled_capabilities
string[] | null

Names of the capabilities currently active on this account. A convenience view of capabilities.

Example:
capabilities
object | null

Each capability's status, keyed by capability name. Populated on single-account reads only; null on list items.

requirements
object | null

Outstanding requirements for this account. Populated on single-account reads only; null on list items.

is_active
boolean

When false, the account is deactivated and cannot authenticate or move funds.

Example:

true

created_at
string

When the account was created, ISO 8601 in UTC.

Example:

"2026-08-01T09:12:44.000Z"

updated_at
string

When the account was last updated, ISO 8601 in UTC.

Example:

"2026-08-07T11:04:22.518Z"

responsibilities
object | null

Fee arrangement for an account you own. null when this object is not an account you own.

configuration
object | null

Personas applied to this account, keyed by name (merchant, recipient), each with an empty object as its value. Populated on single-account reads, where it is {} when none apply; null on list items.

Example: