Get Wallet Balance

Use this endpoint to retrieve the balance of your wallet.

Endpoint

POST /wallet/balance

---

Request

Headers

• Content-Type* — Must be application/json

• x-account-id* — Your unique TemboPlus account identifier

• x-secret-key* — Your TemboPlus API secret key

• x-request-id* — Unique UUID per request for tracing

Body Parameters

• accountNo* (string) — Wallet account number.

---

Responses

200 OK

Returns the current and available balance along with account details such as account name, number and status.

Response Format

{
    "availableBalance": 4500000,
    "currentBalance": 4500000,
    "accountStatus": "ACTIVE",
    "accountNo": "9000112233",
    "accountName": "ACME CORP",
    "type": "DEFAULT DISBURSEMENT",
    "currencyCode": "TZS",
    "countryCode": "TZ"
}

400 BAD REQUEST

A validation error when a required header or required accountNo is not passed

Response Format

{
    "statusCode": 400,
    "reason": "VALIDATION_ERROR",
    "details": {
        "accountNo": "\"accountNo\" is required"
    },
    "message": "{\"accountNo\":\"\\\"accountNo\\\" is required\"}"
}

404 NOT FOUND

A wallet with the passed account no is not found

Response Format

{
    "statusCode": 404,
    "reason": "NOT_FOUND",
    "details": {}
}

401 UNAUTHORIZED

Returned when authentication headers are missing or invalid.

Response Format:

{
    "statusCode": 401,
    "reason": "INVALID_CREDENTIALS",
    "details": {}
}

500 INTERNAL SERVER ERROR

Indicates a temporary issue within TemboPlus. Retry later or contact TemboPlus Support with your x-request-id.

Response Format:

{
    "statusCode": 500,
    "reason": "SERVER_ERROR"
}