---
title: "Retrieve balance"
method: GET
path: "/v1/balance"
---

# Retrieve balance

`GET /v1/balance`

Retrieves the current account balance, based on the authentication that was used to make the request. For a sample request, see [Accounting for negative balances](/docs/connect/account-balances#accounting-for-negative-balances).

## Query parameters

- `expand` string[]

## Response `200`

Successful response.

- Balance — This is an object representing your Stripe balance. You can retrieve it to see the balance currently on your Stripe account. The top-level `available` and `pending` comprise your "payments balance." Related guide: [Balances and settlement time](https://docs.stripe.com/payments/balances), [Understanding Connect account balances](https://docs.stripe.com/connect/account-balances)
  - `available` BalanceAmount[], required — Available funds that you can transfer or pay out automatically by Stripe or explicitly through the [Transfers API](https://api.stripe.com#transfers) or [Payouts API](https://api.stripe.com#payouts). You can find the available balance for each currency and payment type in the `source_types` property.
    - `amount` integer, required — Balance amount.
    - `currency` string, currency, required — Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
    - `source_types` BalanceAmountBySourceType
      - `bank_account` integer — Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
      - `card` integer — Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
      - `fpx` integer — Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
  - `connect_reserved` BalanceAmount[] — Funds held due to negative balances on connected accounts where [account.controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `application`, which includes Custom accounts. You can find the connect reserve balance for each currency and payment type in the `source_types` property.
    - `amount` integer, required — Balance amount.
    - `currency` string, currency, required — Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
    - `source_types` BalanceAmountBySourceType
      - `bank_account` integer — Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
      - `card` integer — Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
      - `fpx` integer — Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
  - `instant_available` BalanceAmountNet[] — Funds that you can pay out using Instant Payouts.
    - `amount` integer, required — Balance amount.
    - `currency` string, currency, required — Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
    - `net_available` BalanceNetAvailable[] — Breakdown of balance by destination.
      - `amount` integer, required — Net balance amount, subtracting fees from platform-set pricing.
      - `destination` string, required — ID of the external account for this net balance (not expandable).
      - `source_types` BalanceAmountBySourceType
        - `bank_account` integer — Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
        - `card` integer — Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
        - `fpx` integer — Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
    - `source_types` BalanceAmountBySourceType
      - `bank_account` integer — Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
      - `card` integer — Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
      - `fpx` integer — Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
  - `issuing` BalanceDetail
    - `available` BalanceAmount[], required — Funds that are available for use.
      - `amount` integer, required — Balance amount.
      - `currency` string, currency, required — Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
      - `source_types` BalanceAmountBySourceType
        - `bank_account` integer — Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
        - `card` integer — Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
        - `fpx` integer — Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
  - `livemode` boolean, required — Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
  - `object` 'balance', required — String representing the object's type. Objects of the same type share the same value.
  - `pending` BalanceAmount[], required — Funds that aren't available in the balance yet. You can find the pending balance for each currency and each payment type in the `source_types` property.
    - `amount` integer, required — Balance amount.
    - `currency` string, currency, required — Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
    - `source_types` BalanceAmountBySourceType
      - `bank_account` integer — Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
      - `card` integer — Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
      - `fpx` integer — Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
  - `refund_and_dispute_prefunding` BalanceDetailUngated
    - `available` BalanceAmount[], required — Funds that are available for use.
      - `amount` integer, required — Balance amount.
      - `currency` string, currency, required — Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
      - `source_types` BalanceAmountBySourceType
        - `bank_account` integer — Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
        - `card` integer — Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
        - `fpx` integer — Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
    - `pending` BalanceAmount[], required — Funds that are pending
      - `amount` integer, required — Balance amount.
      - `currency` string, currency, required — Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
      - `source_types` BalanceAmountBySourceType
        - `bank_account` integer — Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
        - `card` integer — Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
        - `fpx` integer — Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/stainless-api/apis/stripe-api.md) · [All operations](https://skmtc.net/stainless-api/apis/stripe-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stainless-api/stripe-api/versions/d7db5d2f2f83/schema)