Wallet Balance

This endpoint allows you get your Squad Wallet Balance. Please be informed that the wallet balance is in KOBO. (Please note that you can't get wallet balance for Dollar transactions)

This documentation site has been deprecated as of September 8, 2025, and will no longer receive updates. Please refer to the new documentation site at https://docs.squadco.com.

Authorization Any request made without the authorization key will fail with a 401 (Service Not Authorized) response code.

Authorization would be done via Headers using Keys gotten from your dashboard.

Example: Authorization: Bearer sandbox_sk_94f2b798466408ef4d19e848ee1a4d1a3e93f104046f

This endpoint allows you get your Squad Wallet Balance. Amount is in KOBO.

GET https://sandbox-api-d.squadco.com/merchant/balance

Query Parameters

Name	Type	Description
currency_id*	String	It only takes the value "NGN". (Please note that you can't get wallet balance for Dollar transactions)

200: OK Successful

{
    "status": 200,
    "success": true,
    "message": "Success",
    "data": {
        "balance": "2367013",
        "currency_id": "NGN",
        "merchant_id": "SBN1EBZEQ8"
    }
}

401: Unauthorized No Authoirzation

{
    "success": false,
    "message": "",
    "data": {}
}

403: Forbidden Wrong/Invalid API Key

{
    "success": false,
    "message": "Merchant authentication failed",
    "data": {}
}