Skip to main content
GET
/
v1
/
balance
JavaScript
import FingoPay from '@fingoafrica/fingo-pay';

const client = new FingoPay({
  apiKey: process.env['FINGO_PAY_API_KEY'], // This is the default and can be omitted
});

const account = await client.accounts.get();

console.log(account.data);
{
  "status": "success",
  "message": "Balance fetched",
  "data": {
    "account": "collections",
    "balance": 9876543,
    "currency": "KES",
    "available": 9876543,
    "pending": 0,
    "updatedAt": "2025-08-15T12:05:00Z",
    "accountNo": "ACC-123456"
  }
}

Authorizations

​
Authorization
string
header
required

Use your API key as a Bearer token. Example: Authorization: Bearer sk_live_...

Query Parameters

​
account
enum<string>

Account type to get balance for. Cannot be used with accountNo.

Available options:
collections,
payouts
​
accountNo
string

Specific account number to get balance for. Cannot be used with account.

Response

Balance fetched successfully

​
status
string
required
Example:

"success"

​
message
string
required
Example:

"Balance fetched"

​
data
object
required