Get Disbursement Wallet Statement

Use this endpoint to retrieve the statement of your disbursement wallet

Endpoint

POST /wallet/main-statement

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

• startDate* (string) — The starting date of the statement period, formatted as YYYY-MM-DD.

• endDate* (string) — The ending date of the statement period, formatted as YYYY-MM-DD.

Example Request Payload

{
  "startDate": "2025-09-01",
  "endDate": "2025-09-30"
}

Responses

200 OK

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

Response Format

[
  {
    "tranRefNo": "ab3RFcie0X8P",
    "cbaRefNo": null,
    "valueDate": "2025-09-10 09:43:50",
    "txnDate": "2025-09-10 09:43:50",
    "narration": "Test Mobile Payout",
    "debitOrCredit": "DR",
    "amountCredited": 0,
    "amountDebited": 2000,
    "balance": 87000
  },
  {
    "tranRefNo": "e47b1d92-3f5a-4f21-8c9f-92e4e09c73b1-PAYOUT", // Service fee transaction reference
    "cbaRefNo": null,
    "valueDate": "2025-09-10 15:31:50",
    "txnDate": "2025-09-10 15:31:50",
    "narration": "SERVICE FEE FOR REF:e47b1d92-3f5a-4f21-8c9f-92e4e09c73b1 TXNID:VgBcrY3tM4zB Test Mobile Payout", // Service fee description
    "debitOrCredit": "DR",
    "amountCredited": 0,
    "amountDebited": 1000,
    "balance": 84000
  }
]

400 BAD REQUEST

Returned when the request payload is missing one or more required fields, or when any field contains invalid data.

Response Format

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

Fields inside details and message are optional and vary depending on the specific validation failure.

---

Common Validation Errors to Avoid

• Ensure all required fields are included in the request body in the right format.

• x-request-id must be included in the request headers.

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"
}