Skip to main content
GET
/
v1
/
balance
Get account balance
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fingopay.io/v1/balance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "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

​
accountNo
string
required

Specific account number to get balance for. This is the supported selector for balance lookup.

Response

Balance fetched successfully

​
status
string
required
Example:

"success"

​
message
string
required
Example:

"Balance fetched"

​
data
object
required