How can I retrieve balance data from Stripe's API for connected accounts using Postman?

Below is the information on the correct endpoint to use for retrieving the account balance.

Correct API Endpoint

To get the balance data, use the following endpoint:

GET https://api.stripe.com/v1/balance

This endpoint returns a balance object containing the available, pending, and reserved funds.

Example cURL Request

BASHCopied
curl https://api.stripe.com/v1/balance \
  -u "sk_test_4eC39HqLyjWDarjtT1zdp7dc:"

Notes

• Authentication:
  Use your live or test secret key as the basic auth username. The password can be left empty.

• Connected Accounts:
  If you're trying to retrieve the balance for a connected account, do not call the /v1/accounts/<acct_id> endpoint. Instead, use the balance endpoint with an additional header:

  BASHCopied
  curl https://api.stripe.com/v1/balance \
    -u "sk_test_4eC39HqLyjWDarjtT1zdp7dc:" \
    -H "Stripe-Account: acct_1NfnzBHIBayKCYf4"

  This passes the connected account ID (acct_1NfnzBHIBayKCYf4) in the request header, allowing you to retrieve the balance for that account.

• Response Structure:
  The response will include fields such as available, pending, and connect_reserved (as applicable), all structured by currency.

Using the /v1/balance endpoint (and the optional Stripe-Account header for connected accounts) will fetch the balance data rather than using the /v1/accounts/<acct_id> endpoint, which does not include the balance information.