GET/v1/account

Retrieve account

Retrieves the details of the authenticated user's account. This endpoint returns comprehensive account information including business profile, capabilities, charges status, and any pending requirements. Use the expand parameter to include nested objects in the response.

1 parameter
expandarray<string>optional

Specifies which fields in the response should be expanded.

2 status codes
200Returns the account object with all current properties including business type, capabilities, charges enabled status, and requirements.
business_profileobjectoptional

Business information about the account.

business_typestringoptional

The business type.

Allowed:companygovernment_entityindividualnon_profit
capabilitiesobjectoptional
charges_enabledbooleanoptional

Whether the account can process charges.

companyobjectoptional
controllerobjectoptional
countrystringoptional

The account's country.

createdintegeroptional

Time at which the account was connected. Measured in seconds since the Unix epoch.

default_currencystringoptional

Three-letter ISO currency code representing the default currency for the account. This must be a currency that Stripe supports in the account's country.

details_submittedbooleanoptional

Whether account details have been submitted. Accounts with Stripe Dashboard access, which includes Standard accounts, cannot receive payouts before this is true. Accounts where this is false should be directed to an onboarding flow to finish submitting account details.

emailstringoptional

An email address associated with the account. It's not used for authentication and Stripe doesn't market to this field without explicit approval from the platform.

external_accountsobjectoptional

External accounts (bank accounts and debit cards) currently attached to this account. External accounts are only returned for requests where controller[is_controller] is true.

future_requirementsobjectoptional
groupsobjectoptional

The groups associated with the account.

idstringrequired

Unique identifier for the object.

individualobjectoptional

This is an object representing a person associated with a Stripe account.

A platform can only access a subset of data in a person for an account where account.controller.requirement_collection is stripe, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding.

See the Standard onboarding or Express onboarding documentation for information about prefilling information and account onboarding steps. Learn more about handling identity verification with the API.

metadataobjectoptional

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

objectstringrequired

String representing the object's type. Objects of the same type share the same value.

Allowed:account
payouts_enabledbooleanoptional

Whether the funds in this account can be paid out.

requirementsobjectoptional
settingsobjectoptional

Options for customizing how the account functions within Stripe.

tos_acceptanceobjectoptional
typestringoptional

The Stripe account type. Can be standard, express, custom, or none.

Allowed:customexpressnonestandard
defaultError response.
errorobjectrequired