AI agents: this site is available as Markdown at /llms.txt. Each page has a Markdown version at its URL with a .md suffix, and the full API is described in /api/v3/openapi.json.

Documentation

Learn to build with Flutterwave

API Reference

Get started with API calls

Get available balance

Initiate wallet refund

2026 © Flutterwave

Get available balance

Get the available balance of a payout subaccount.

Last updated 13 September 2026

get

https://api.flutterwave.com/v3/payout-subaccounts/{account_reference}/balances

authorization string required

Pass your secret key as a bearer token in the request header to authorize this call

FILL IN ALL REQUIRED FIELDS

account_reference string required
Unique identifier for the payout subaccount

FILL IN ALL REQUIRED FIELDS

currency string
Defaults to currency of the subaccount. Possible value is NGN.

Shell

Account transactions

Get static accounts

Was this page helpful?

FL.AI

Answers from the Flutterwave docs

Hi, I’m FL.AI

Ask anything about Flutterwave’s APIs, guides and coverage.

FL.AI can make mistakes. Check important details in the docs.

⌘K

Start typing to search the flutterwave documentation.

Get available balance

Initiate wallet refund