Skip to navigation

List VTU Transactions

View as Markdown

Lists your airtime/data/utility/cable TV purchase history.

Query params (all optional):

ParamTypeNotes
pageintegerdefault 1
limitintegerdefault 20, max 100
statusenumPENDING, SUCCESS, FAILED, REVERSED (case-sensitive; leave empty for all)
typeenumAIRTIME, DATA, CABLE_TV, UTILITY (case-sensitive)

Sorted newest first. product is null for airtime and utility. Invalid enum values or non-numeric page/limit are not validated and cause a server error.

Error format: body validation failures (Joi) return { "status": "error", "message": "Validation error", "details": [ ... ] }; all other errors return { "success": false, "message": "..." }. Money fields (amount, fee) are Prisma Decimals and are serialized as strings (e.g. "1000").

Authentication

AuthorizationBearer

Access token from Generate Access Token (valid 15 minutes).

Query parameters

pagestringOptional
limitstringOptional
statusstringOptional
typestringOptional

Response

OK
successbooleanOptional
datalist of objectsOptional
metaobjectOptional

Errors

401
Unauthorized Error
403
Forbidden Error