Sample - Stripe API
GET/v1/financial_connections/accounts/{account}

Retrieve a Financial Connections account

Retrieves a Financial Connections account by its identifier. Use expand to include selected related fields in expanded form. The response includes account category, institution, ownership, permissions, balance information, and account status.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
accountstringrequired
The unique identifier of the Financial Connections account to retrieve; the identifier can contain up to 5,000 characters.
expandarray<string>optional
Specifies which fields in the response to expand; each field name can contain up to 5,000 characters.

2 status codes
200Returns the Financial Connections account with its identifier, category, institution name, account holder, balances, ownership, permissions, account status, and supported payment method types.
account_holderobjectoptional
The account holder that this account belongs to.
account_numbersarray<BankConnectionsResourceAccountNumberDetails>optional
Details about the account numbers.
balanceobjectoptional
The most recent information about the account's balance.
balance_refreshobjectoptional
The state of the most recent attempt to refresh the account balance.
categorystringrequired
The type of the account. Account category is further divided in `subcategory`.
Allowed:cashcreditinvestmentother
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
display_namestringoptional
A human-readable name that has been assigned to this account, either by the account holder or by the institution.
idstringrequired
Unique identifier for the object.
institution_namestringrequired
The name of the institution that holds this account.
last4stringoptional
The last 4 digits of the account number. If present, this will be 4 numeric characters.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:financial_connections.account
ownershipstringoptional
The most recent information about the account's owners.
ownership_refreshobjectoptional
The state of the most recent attempt to refresh the account owners.
permissionsarray<string>optional
The list of permissions granted by this account.
statusstringrequired
The status of the link to the account.
Allowed:activedisconnectedinactive
status_detailsobjectoptional
subcategorystringrequired
If `category` is `cash`, one of: - `checking` - `savings` - `other` If `category` is `credit`, one of: - `mortgage` - `line_of_credit` - `credit_card` - `other` If `category` is `investment` or `other`, this will be `other`.
Allowed:checkingcredit_cardline_of_creditmortgageothersavings
subscriptionsarray<string>optional
The list of data refresh subscriptions requested on this account.
supported_payment_method_typesarray<string>required
The [PaymentMethod type](https://docs.stripe.com/api/payment_methods/object#payment_method_object-type)(s) that can be created from this account.
transaction_refreshobjectoptional
The state of the most recent attempt to refresh the account transactions.
defaultError response.
errorobjectrequired

Error handling

account must identify an existing Financial Connections account and can contain up to 5,000 characters. Each expand value must not exceed 5,000 characters.