--- title: "List all FinancialAccounts" method: GET path: "/v1/treasury/financial_accounts" --- # List all FinancialAccounts `GET /v1/treasury/financial_accounts` ## Request - Base URL: `https://api.stripe.com` - URL: `https://api.stripe.com/v1/treasury/financial_accounts` - Auth: one of: - HTTP basic - HTTP bearer Returns a list of FinancialAccounts. ## Query parameters - `created` union - object - `gt` integer - `gte` integer - `lt` integer - `lte` integer - integer - `ending_before` string - `expand` string[] - `limit` integer - `starting_after` string - `status` 'closed' | 'open' ## Response `200` Successful response. - object - `data` TreasuryFinancialAccount[], required - `active_features` string[]: The array of paths to active Features in the Features hash. - `balance` TreasuryFinancialAccountsResourceBalance, required: Balance information for the FinancialAccount - `cash` object, required: Funds the user can spend right now. - `inbound_pending` object, required: Funds not spendable yet, but will become available at a later time. - `outbound_pending` object, required: Funds in the account, but not spendable because they are being held for pending outbound flows. - `country` string, required: Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)). - `created` integer, required: Time at which the object was created. Measured in seconds since the Unix epoch. - `features` TreasuryFinancialAccountFeatures: Encodes whether a FinancialAccount has access to a particular Feature, with a `status` enum and associated `status_details`. Stripe or the platform can control Features via the requested field. - `card_issuing` TreasuryFinancialAccountsResourceToggleSettings: Toggle settings for enabling/disabling a feature - `requested` boolean, required: Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature. - `deposit_insurance` TreasuryFinancialAccountsResourceToggleSettings: Toggle settings for enabling/disabling a feature - `requested` boolean, required: Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature. - `financial_addresses` TreasuryFinancialAccountsResourceFinancialAddressesFeatures: Settings related to Financial Addresses features on a Financial Account - `aba` TreasuryFinancialAccountsResourceAbaToggleSettings: Toggle settings for enabling/disabling the ABA address feature - `requested` boolean, required: Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature. - `inbound_transfers` TreasuryFinancialAccountsResourceInboundTransfers: InboundTransfers contains inbound transfers features for a FinancialAccount. - `ach` TreasuryFinancialAccountsResourceInboundAchToggleSettings: Toggle settings for enabling/disabling an inbound ACH specific feature - `requested` boolean, required: Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature. - `intra_stripe_flows` TreasuryFinancialAccountsResourceToggleSettings: Toggle settings for enabling/disabling a feature - `requested` boolean, required: Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature. - `object` 'treasury.financial_account_features', required: String representing the object's type. Objects of the same type share the same value. - `outbound_payments` TreasuryFinancialAccountsResourceOutboundPayments: Settings related to Outbound Payments features on a Financial Account - `ach` TreasuryFinancialAccountsResourceOutboundAchToggleSettings: Toggle settings for enabling/disabling an outbound ACH specific feature - `requested` boolean, required: Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature. - `us_domestic_wire` TreasuryFinancialAccountsResourceToggleSettings: Toggle settings for enabling/disabling a feature - `requested` boolean, required: Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature. - `outbound_transfers` TreasuryFinancialAccountsResourceOutboundTransfers: OutboundTransfers contains outbound transfers features for a FinancialAccount. - `ach` TreasuryFinancialAccountsResourceOutboundAchToggleSettings: Toggle settings for enabling/disabling an outbound ACH specific feature - `requested` boolean, required: Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature. - `us_domestic_wire` TreasuryFinancialAccountsResourceToggleSettings: Toggle settings for enabling/disabling a feature - `requested` boolean, required: Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature. - `financial_addresses` TreasuryFinancialAccountsResourceFinancialAddress[], required: The set of credentials that resolve to a FinancialAccount. - `aba` TreasuryFinancialAccountsResourceAbaRecord: ABA Records contain U.S. bank account details per the ABA format. - `account_holder_name` string, required: The name of the person or business that owns the bank account. - `account_number` string, nullable: The account number. - `account_number_last4` string, required: The last four characters of the account number. - `bank_name` string, required: Name of the bank. - `routing_number` string, required: Routing number for the account. - `supported_networks` string[]: The list of networks that the address supports - `type` 'aba', required: The type of financial address - `id` string, required: Unique identifier for the object. - `is_default` boolean - `livemode` boolean, required: If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`. - `metadata` object, nullable: Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. - `nickname` string, nullable: The nickname for the FinancialAccount. - `object` 'treasury.financial_account', required: String representing the object's type. Objects of the same type share the same value. - `pending_features` string[]: The array of paths to pending Features in the Features hash. - `platform_restrictions` TreasuryFinancialAccountsResourcePlatformRestrictions: Restrictions that a Connect Platform has placed on this FinancialAccount. - `inbound_flows` 'restricted' | 'unrestricted', nullable: Restricts all inbound money movement. - `outbound_flows` 'restricted' | 'unrestricted', nullable: Restricts all outbound money movement. - `restricted_features` string[]: The array of paths to restricted Features in the Features hash. - `status` 'closed' | 'open', required: Status of this FinancialAccount. - `status_details` TreasuryFinancialAccountsResourceStatusDetails, required - `closed` TreasuryFinancialAccountsResourceClosedStatusDetails - `reasons` string[], required: The array that contains reasons for a FinancialAccount closure. - `supported_currencies` string[], required: The currencies the FinancialAccount can hold a balance in. Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. - `has_more` boolean, required: True if this list has another page of items after this one that can be fetched. - `object` 'list', required: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. - `url` string, required: The URL where this list can be accessed. ## Other responses - `default`: Error response. --- [API](https://skmtc.dev/stainless-api/apis/stripe-api.md) · [All operations](https://skmtc.dev/stainless-api/apis/stripe-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stainless-api/apis/stripe-api/revisions/7cff4cc46d06?raw)