# List Financial Addresses List all FinancialAddresses for a FinancialAccount. ## Parameters - `financial_account` (string, optional) The ID of the FinancialAccount for which FinancialAddresses are to be returned. - `include` (array of enums, optional) A list of fields to reveal in the FinancialAddresses returned. Possible enum values: - `credentials.gb_bank_account.account_number` The full account number of the FinancialAddress for a UK bank account. - `credentials.us_bank_account.account_number` The full account number of the FinancialAddress for a US bank account. - `limit` (integer, optional) The page limit. - `page` (string, optional) The page token. ## Returns ## Response attributes - `data` (array of objects) A list of FinancialAddresses. - `data.id` (string) The ID of a FinancialAddress. - `data.object` (string, value is "v2.money_management.financial_address") String representing the object’s type. Objects of the same type share the same value of the object field. - `data.created` (timestamp) The creation timestamp of the FinancialAddress. - `data.credentials` (object, nullable) Object indicates the type of credentials that have been allocated and attached to the FinancialAddress. It contains all necessary banking details with which to perform money movements with the FinancialAddress. This field is only available for FinancialAddresses with an active status. - `data.credentials.gb_bank_account` (object, nullable) The credentials of the UK Bank Account for the FinancialAddress. This contains unique banking details such as the sort code, account number, etc. of a UK bank account. - `data.credentials.gb_bank_account.account_holder_name` (string) The account holder name to be used during bank transference. - `data.credentials.gb_bank_account.account_number` (string, nullable) The account number of the UK Bank Account. - `data.credentials.gb_bank_account.last4` (string) The last four digits of the UK Bank Account number. This will always be returned. To view the full account number when retrieving or listing FinancialAddresses, use the `include` request parameter. - `data.credentials.gb_bank_account.sort_code` (string) The sort code of the UK Bank Account. - `data.credentials.sepa_bank_account` (object, nullable) The credentials of the SEPA Bank Account for the FinancialAddress. This contains unique banking details such as the IBAN, BIC, etc. of a SEPA bank account. - `data.credentials.sepa_bank_account.account_holder_name` (string) The account holder name to be used during bank transfers. - `data.credentials.sepa_bank_account.bank_name` (string) The name of the Bank. - `data.credentials.sepa_bank_account.bic` (string) The BIC of the SEPA Bank Account. - `data.credentials.sepa_bank_account.country` (enum) The originating country of the SEPA Bank account. - `data.credentials.sepa_bank_account.iban` (string) The IBAN of the SEPA Bank Account. - `data.credentials.sepa_bank_account.last4` (string) The last four digits of the SEPA Bank Account number. This will always be returned. To view the full account number when retrieving or listing FinancialAddresses, use the `include` request parameter. - `data.credentials.type` (enum) The type of Credentials that are provisioned for the FinancialAddress. Possible enum values: - `gb_bank_account` A UK Bank Account credential. This indicates that the associated credentials object contains unique banking details pertinent to a UK bank account. - `us_bank_account` A US Bank Account credential. This indicates that the associated credentials object contains unique banking details pertinent to a US bank account. - `data.credentials.us_bank_account` (object, nullable) The credentials of the US Bank Account for the FinancialAddress. This contains unique banking details such as the routing number, account number, etc. of a US bank account. - `data.credentials.us_bank_account.account_holder_address` (object, nullable) The address of the account holder. - `data.credentials.us_bank_account.account_holder_address.city` (string) The city of the address. - `data.credentials.us_bank_account.account_holder_address.country` (enum) The country of the address. - `data.credentials.us_bank_account.account_holder_address.line1` (string) The first line of the address. - `data.credentials.us_bank_account.account_holder_address.line2` (string) The second line of the address. - `data.credentials.us_bank_account.account_holder_address.postal_code` (string) The postal / zip code of the address. - `data.credentials.us_bank_account.account_holder_address.state` (string) The state of the address. - `data.credentials.us_bank_account.account_holder_address.town` (string) The town of the address. - `data.credentials.us_bank_account.account_holder_name` (string, nullable) The name of the account holder. - `data.credentials.us_bank_account.account_number` (string, nullable) The account number of the US Bank Account. - `data.credentials.us_bank_account.bank_name` (string, nullable) The name of the Bank. - `data.credentials.us_bank_account.last4` (string) The last four digits of the US Bank Account number. This will always be returned. To view the full account number when retrieving or listing FinancialAddresses, use the `include` request parameter. - `data.credentials.us_bank_account.routing_number` (string) The routing number of the US Bank Account. - `data.credentials.us_bank_account.swift_code` (string, nullable) The swift code of the bank or financial institution. - `data.currency` (enum) The currency the FinancialAddress supports. - `data.financial_account` (string) A ID of the FinancialAccount this FinancialAddress corresponds to. - `data.livemode` (boolean) Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. - `data.settlement_currency` (enum, nullable) The currency the FinancialAddress settles into the FinancialAccount. - `data.status` (enum) An enum representing the status of the FinancialAddress. This indicates whether or not the FinancialAddress can be used for any money movement flows. Possible enum values: - `active` The Financial Address is active. - `archived` The Financial Address is archived, it cannot be used anymore. - `failed` The Financial Address creation failed. - `pending` The Financial Address is being created. - `next_page_url` (string, nullable) URL to fetch the next page of the list. If there are no more pages, the value is null. - `previous_page_url` (string, nullable) URL to fetch the previous page of the list. If there are no previous pages, the value is null. ```curl curl https://api.stripe.com/v2/money_management/financial_addresses \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-01-28.preview" ``` ### Response ```json { "data": [ { "id": "finaddr_61O3m0n8AAMZt30I2YH16O0lef0dSQgZ0EhGyZsQCXQHG4", "object": "v2.money_management.financial_address", "credentials": { "type": "us_bank_account", "us_bank_account": { "account_number": null, "routing_number": "110000000", "swift_code": "TSTEZ122", "bank_name": "STRIPE TEST BANK", "last4": "6890" } }, "status": "active", "financial_account": "fa_6504m3x1JLdhVIIIT1A16O0lef0dSQgZ0EhGyZsQCXQ28m", "created": "2023-03-30T17:22:06.188Z", "currency": "usd", "livemode": true }, { "id": "finaddr_61O6nHqDsFuMtECYR16O0lef0dSQgZ0EhGyZsQCXQMls", "object": "v2.money_management.financial_address", "credentials": { "type": "us_bank_account", "us_bank_account": { "account_number": null, "routing_number": "110000000", "swift_code": "TSTEZ122", "bank_name": "STRIPE TEST BANK", "last4": "6891" } }, "status": "active", "financial_account": "fa_6504m3x1JLdhVIIIT1A16O0lef0dSQgZ0EhGyZsQCXQ28m", "created": "2023-03-30T17:32:06.665Z", "currency": "usd", "livemode": true } ], "next_page_url": null, "previous_page_url": null } ```