Sample - Stripe API
GET/v1/linked_accounts

List Financial Connections Accounts

Lists Financial Connections Account objects available to the authenticated user. Filter by account holder or session, and use cursor parameters to navigate the results; limit controls the number of accounts returned per page.

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

6 parameters
account_holderobjectoptional
Filters accounts by account holder using `customer`, `account`, or `customer_account`; `customer` and `account` cannot be used together.
ending_beforestringoptional
An object ID cursor that identifies the end of the current position when retrieving a previous page.
expandarray<string>optional
Fields to expand in the response; each value can contain up to 5000 characters.
limitintegeroptional
Maximum number of accounts to return, from 1 to 100. Defaults to 10 when omitted.
sessionstringoptional
Filters results to accounts collected as part of the specified Financial Connections Session.
starting_afterstringoptional
An object ID cursor that identifies the end of the current page when retrieving the next page.

2 status codes
200Returns a list object containing Financial Connections Accounts in `data`, a `has_more` pagination flag, the list object type, and its access 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.
defaultReturned when the API reports an error; the response contains an `error` object with a `type` field.
errorobjectrequired

Error handling

account_holder[customer] and account_holder[account] are mutually exclusive when supplied. limit must be between 1 and 100 and defaults to 10; use starting_after or ending_before as object-ID cursors for pagination.