Wallet & Top-ups
Get Wallet Balance
Return available, held, and total balance for the API key owner.
Endpoint
GET /api/v1/wallet-balance
Response
Returns wallet balance information for the authenticated API key owner.
{
"success": true,
"data": {
"availableBalance": 0,
"currency": "GHS",
"heldBalance": 0,
"lastUpdated": 1769109065157,
"totalBalance": 0,
"userProfileId": "user_profile_abc123"
}
}Response fields
| Field | Type | Notes |
|---|---|---|
userProfileId | userProfiles id | Owner of the wallet |
availableBalance | number | Funds immediately spendable (GHS) |
heldBalance | number | Funds reserved for pending orders (GHS) |
totalBalance | number | Sum of available and held (GHS) |
currency | string | Always GHS (Ghana Cedis) |
lastUpdated | number | Unix epoch timestamp in milliseconds |
Sample request
curl -X GET "https://api.netconnectgh.online/api/v1/wallet-balance" \
-H "X-API-KEY: netconnect_live_your_secret_here" \
-H "Content-Type: application/json"