Retrieve account

Changed on

Retrieves the details of an account.

get/v1/account

Request

  • Base URL: https://api.stripe.com
  • URL: https://api.stripe.com/v1/account
  • Auth: HTTP bearer

Query parameters

expandstring[]

Specifies which fields in the response should be expanded.

Response

Successful response.

business_type'company' | 'government_entity' | 'individual' | 'non_profit' nullable

The business type.

charges_enabledboolean

Whether the account can process charges.

countrystring

The account's country.

createdinteger

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

default_currencystring

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_submittedboolean

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.

emailstring nullable

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.

idstring required

Unique identifier for the object.

metadataobject

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.

object'account' required

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

payouts_enabledboolean

Whether the funds in this account can be paid out.

type'custom' | 'express' | 'none' | 'standard'

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

Changes