Skip to main content
GET
/
v1
/
balance
Get account balance
curl --request GET \
  --url https://api.fingopay.io/v1/balance \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "message": "Balance fetched",
  "data": {
    "account": "b2c",
    "balance": 9876543,
    "currency": "KES",
    "available": 9876543,
    "pending": 0,
    "updatedAt": "2025-08-15T12:05:00Z"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
account
enum<string>
required
Available options:
collections,
payouts

Response

Balance fetched

​
status
string
Example:

"success"

​
message
string
Example:

"Balance fetched"

​
data
object
⌘I