Sample - Stripe API
GET/v1/financial_connections/accounts

List Financial Connections accounts

Lists Financial Connections accounts. Filter the results by account holder or session, and use cursor parameters with limit to paginate the returned accounts. Each result describes an account held outside the payment platform.

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

6 parameters
account_holderobjectoptional
Filters accounts by holder using an account, customer, or customer account identifier; `customer` and `account` cannot be used together.
ending_beforestringoptional
A cursor containing an account object ID; returns the page before that position.
expandarray<string>optional
Specifies which fields in the response to expand; each field name can contain up to 5,000 characters.
limitintegeroptional
The number of accounts to return. Must be between 1 and 100 and defaults to 10 when omitted.
sessionstringoptional
Filters results to accounts collected during the specified Financial Connections session.
starting_afterstringoptional
A cursor containing an account object ID; returns the page after that position.

2 status codes
200Returns a list of Financial Connections account objects with account data, a `has_more` indicator, the list object type, and the list URL.
dataarray<Account>required
Details about each object.
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
Allowed:list
urlstringrequired
The URL where this list can be accessed.
defaultError response.
errorobjectrequired

Error handling

account_holder[customer] and account_holder[account] are mutually exclusive; provide at most one of them. limit must be an integer between 1 and 100 and defaults to 10 when omitted, while cursor values must identify list positions.