Bill Payment · BBPS

BBPS Categories

List BBPS operator categories

GET request

URL: https://uat-api.vizodigital.com/api/v1/bill-payment/bbps/categories

Include a valid Bearer token with every request

Code sample

curl -X GET "https://uat-api.vizodigital.com/api/v1/bill-payment/bbps/categories" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Success response

{
    "status": "success",
    "message": "BBPS categories retrieved.",
    "data": {
        "categories": [
            "Electricity Bill",
            "Gas",
            "Water Bill"
        ]
    }
}

Failure response

{
    "status": "error",
    "message": "Request failed. Check credentials, wallet balance, or validation errors."
}

Overview

Returns every BBPS category available for operator lookup (Electricity, Gas, Water, Broadband, etc.).

Access

Requires BBPS bill fetch (bbps_bill_fetch) enabled under Plan API access.

Responses

200 · application/json default

Categories list

Example

{
    "status": "success",
    "message": "BBPS categories retrieved.",
    "data": {
        "categories": [
            "Electricity Bill",
            "Gas",
            "Water Bill"
        ]
    }
}

Rate Limits

60/min