Get Wallet Balance

Developing

GET

/api/v1/public/company/wallet/balance

Returns the current wallet balance of the company that owns the API key, in NGN. This call is free and reads the balance already loaded during API-key authentication, so it always reflects the state at the start of the request.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Responses

🟢200

application/json

Current balance returned.

Bodyapplication/json

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/public/company/wallet/balance' \
--header 'X-Api-Key: <api-key>'

Response Example

200 - Example 1

{
    "status": true,
    "message": "Operation successful.",
    "data": {
        "balance": 125400.5,
        "currency": "NGN"
    }
}

Modified at 2026-08-06 11:58:31

Verify A NIN

Get Customer Proximity Summary