Sample - Stripe API
GET/v1/balance

Retrieve the account balance

Retrieves the current balance for the account associated with the request authentication. Use expand when you need selected response fields expanded.

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

1 parameter
expandarray<string>optional
Specifies response fields to expand; each value can be up to 5000 characters.

2 status codes
200Returns the account balance, including available and pending funds, supported balance details, live-mode status, and the balance object type.
availablearray<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.
connect_reservedarray<BalanceAmount>optional
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.
instant_availablearray<BalanceAmountNet>optional
Funds that you can pay out using Instant Payouts.
issuingobjectoptional
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:balance
pendingarray<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.
refund_and_dispute_prefundingobjectoptional
defaultError response.
errorobjectrequired

Error handling

Each expand value must be a string of no more than 5000 characters. Omit expand when no response fields require expansion.