Skip to navigation

List Category Products

View as Markdown

Lists purchasable products under a category (e.g. specific data bundles or cable TV packages) and their categoryProductIds, amounts, and validity.

Path: serviceCategoryId (string, required). Returns active products only. categoryProductId is the productId for Purchase Data / Purchase Cable TV. categoryProductName falls back to validity when the product has no name. amount is a Decimal serialized as a string.

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).

Path parameters

serviceCategoryIdstringRequired
A category ID from List Service Categories.

Response

Success (MTN data) / Success (DStv packages)

successbooleanOptional
datalist of objectsOptional

Errors

401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error