Sample - Stripe API
POST/v1/financial_connections/accounts/{account}/disconnect

Disconnect a Financial Connections account

Disconnects a Financial Connections account and disables access to its associated data. After disconnection, the authenticated user can no longer access data such as balances or transactions for that account. Use expand to control related fields included in the response.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.
  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
accountstringrequired
The unique identifier of the Financial Connections account to disconnect; the identifier can contain up to 5,000 characters.

Optional disconnection settings controlling expanded fields in the response.

expandarray<string>optional
Specifies which fields in the response should be expanded.

2 status codes
200Returns the disconnected Financial Connections account with its identifier, account details, ownership, permissions, balance information, and updated account status.
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 the Financial Connections account to disconnect and can contain up to 5,000 characters. Each expand value must not exceed 5,000 characters; disconnection removes access to the account's associated data.