Transfer API
Account balances
Retrieve the balance of your merchant account per currency. Check it before initiating payouts to make sure funds and fees are covered.
Method & URL
GEThttps://api.katika-bridge.com/balances
Example request
GET /balances
curl -X GET "https://api.katika-bridge.com/balances" \
-H "x-api-key: your_api_key_here" \
-H "x-api-secret: your_api_secret_here"Success response (200 OK)
200 OK
{
"error": false,
"statusCode": 200,
"message": "Balances retrieved successfully",
"data": [
{
"currency": "XAF",
"availableBalance": 2540000,
"pendingBalance": 150000,
"updatedAt": "2026-02-02T17:04:09.588Z"
}
]
}Response fields
| Field | Type | Description |
|---|---|---|
| currency | string | Currency of the balance (e.g. XAF, XOF) |
| availableBalance | number | Amount immediately usable for new transfers |
| pendingBalance | number | Amount reserved by transactions still being processed |
| updatedAt | string (ISO) | Last time the balance was updated |
A transfer debits amount + feeAmount, so make sure availableBalance covers the total, not just the transfer amount.
Possible errors
| HTTP code | Description |
|---|---|
| 400 / 404 | Authentication error — see Authentication |
| 500 | Server error (internal problem during request processing) |