List all FinancialAccount objects v2

Money Management
Financial Accounts
List all FinancialAccount objects

Lists FinancialAccounts in this compartment.

Learn more about calling API v2 endpoints.

Parameters

  • limitinteger

    The page limit.

  • pagestring

    The page token.

Returns

Response attributes

  • dataarray of objects

    Financial Accounts retrieved.

    • data.idstring

      Unique identifier for the object.

    • data.objectstring, value is "v2.money_management.financial_account"

      String representing the object’s type. Objects of the same type share the same value of the object field.

    • data.balanceobject

      Multi-currency balance of this FinancialAccount, split by availability state. Each balance is represented as a hash where the key is the three-letter ISO currency code, in lowercase, and the value is the amount for that currency.

      • data.balance.availablemap

        Balance that can be used for money movement.

      • data.balance.inbound_pendingmap

        Balance of inbound funds that will later transition to the cash balance.

      • data.balance.outbound_pendingmap

        Balance of funds that are being used for a pending outbound money movement.

    • data.countryenum

      Two-letter country code that represents the country where the LegalEntity associated with the FinancialAccount is based in.

    • data.createdtimestamp

      Time at which the object was created.

    • data.descriptionnullable string

    • data.livemodeboolean

      Has the value true if the object exists in live mode or the value false if the object exists in test mode.

    • data.othernullable object

      If this is a other FinancialAccount, this hash indicates what the actual type is. Upgrade your API version to see it reflected in type.

      • data.other.typestring

        The type of the FinancialAccount, represented as a string. Upgrade your API version to see the type reflected in financial_account.type.

    • data.statusenum

      An enum representing the status of the FinancialAccount. This indicates whether or not the FinancialAccount can be used for any money movement flows.

      Possible enum values
      closed

      The FinancialAccount is closed and cannot be used anymore.

      open

      The FinancialAccount is open and available for use.

    • data.storagenullable object

      If this is a storage FinancialAccount, this hash includes details specific to storage FinancialAccounts.

      • data.storage.holds_currenciesarray of enums

        The currencies that this FinancialAccount can hold.

    • data.typeenum

      Type of the FinancialAccount. An additional hash is included on the FinancialAccount with a name matching this value. It contains additional information specific to the FinancialAccount type.

      Possible enum values
      other

      The API version used does not support the FinancialAccount’s type.

      storage

      Used for the long term storage of funds and sending those funds to others.

  • next_page_urlnullable string

    The next page URL.

  • previous_page_urlnullable string

    The previous page URL.

GET /v2/money_management/financial_accounts
curl https://api.stripe.com/v2/money_management/financial_accounts \
-H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
-H "Stripe-Version: 2025-05-28.preview"
Response
{
"data": [
{
"id": "fa_65NvTFNdpXXUx1kx1rB16NoTesLDSQ1IgNPigisRKq09iq",
"object": "v2.money_management.financial_account",
"balance": {
"available": {
"usd": {
"value": 0,
"currency": "usd"
}
},
"inbound_pending": {
"usd": {
"value": 0,
"currency": "usd"
}
},
"outbound_pending": {
"usd": {
"value": 0,
"currency": "usd"
}
}
},
"country": "US",
"created": "2023-02-24T22:48:56.363Z",
"description": "This is a sample Financial Account.",
"status": "open",
"storage": {
"holds_currencies": [
"usd"
]
},
"type": "storage",
"livemode": true
}
],
"next_page_url": null,
"previous_page_url": null
}