Product categories
Retrieve the list of product categories supported by LedgerBlock's Utility APIs.
Product categories can be used to identify the type of utility product or service you want to query or purchase.
Endpoint
GET {{base_url}}/api/v1/utility/categoriesHeaders
| Header | Type | Required | Description |
|---|---|---|---|
x-merchant-ref | string | Yes | Your unique merchant reference. |
Request
This endpoint does not require a request body.
Example Request
curl --request GET \
--url '{{base_url}}/api/v1/utility/categories' \
--header 'x-merchant-ref: YOUR_MERCHANT_REF'Response
A successful request returns a list of available product categories. Each category contains:
| Field | Type | Description |
|---|---|---|
code | string | Unique code assigned to the category. |
name | string | Name of the product category. |
Example Response
{
"status": "success",
"message": "Fetched",
"data": {
"data": [
{
"code": "1.0",
"name": "Mobile Top Up"
},
{
"code": "2.0",
"name": "Mobile PIN"
},
{
"code": "3.0",
"name": "Bill Payment"
},
{
"code": "4.0",
"name": "Mobile Data"
},
{
"code": "4.1",
"name": "Mobile Data > Daily Bundles"
},
{
"code": "4.2",
"name": "Mobile Data > 7-14 Day Bundles"
},
{
"code": "4.3",
"name": "Mobile Data > Monthly Bundles"
},
{
"code": "4.4",
"name": "Mobile Data > Extended Validity Bundles"
},
{
"code": "4.5",
"name": "Mobile Data > Special Offers"
},
{
"code": "4.6",
"name": "Mobile Data > SME Data Share Bundles"
},
{
"code": "5.0",
"name": "Voice, Data & Combo Bundles"
},
{
"code": "6.0",
"name": "Internet Services"
},
{
"code": "7.0",
"name": "Cable TV"
},
{
"code": "8.0",
"name": "Utilities"
},
{
"code": "8.1",
"name": "Utilities > Electricity"
},
{
"code": "8.2",
"name": "Utilities > Water"
},
{
"code": "8.3",
"name": "Utilities > Transport & Toll Payment"
},
{
"code": "9.0",
"name": "Betting"
},
{
"code": "10.0",
"name": "Taxes"
},
{
"code": "10.1",
"name": "Taxes > Federal"
},
{
"code": "10.2",
"name": "Taxes > State"
},
{
"code": "11.0",
"name": "Lifestyle"
},
{
"code": "11.1",
"name": "Lifestyle > Education"
},
{
"code": "11.2",
"name": "Lifestyle > Healthcare"
},
{
"code": "11.3",
"name": "Lifestyle > Insurance"
},
{
"code": "12.0",
"name": "Retail Gift Cards"
},
{
"code": "13.0",
"name": "eVouchers"
},
{
"code": "13.1",
"name": "eVouchers > Beauty and Wellness"
},
{
"code": "13.2",
"name": "eVouchers > Book store, e-shop"
},
{
"code": "13.3",
"name": "eVouchers > Clothing and Accessories"
},
{
"code": "13.4",
"name": "eVouchers > Cosmetics Perfumes"
},
{
"code": "13.5",
"name": "eVouchers > Department Store"
},
{
"code": "13.6",
"name": "eVouchers > Ecommerce"
},
{
"code": "13.7",
"name": "eVouchers > Electronics, Games"
},
{
"code": "13.8",
"name": "eVouchers > Electronics, White Goods"
},
{
"code": "13.9",
"name": "eVouchers > Food & Restaurants"
},
{
"code": "13.11",
"name": "eVouchers > Home and Maintenance"
},
{
"code": "13.12",
"name": "eVouchers > Kids"
},
{
"code": "13.13",
"name": "eVouchers > Music, Cinema, Entertainment"
},
{
"code": "13.14",
"name": "eVouchers > Multi online store"
},
{
"code": "13.15",
"name": "eVouchers > Sport and Leisure"
},
{
"code": "13.16",
"name": "eVouchers > Transportation"
},
{
"code": "13.17",
"name": "eVouchers > Travel"
},
{
"code": "13.18",
"name": "eVouchers > Automobiles"
},
{
"code": "13.19",
"name": "eVouchers > Baby & Kids"
},
{
"code": "13.21",
"name": "eVouchers > Charity & Donations"
},
{
"code": "13.22",
"name": "eVouchers > Education"
},
{
"code": "13.23",
"name": "eVouchers > Electronics"
},
{
"code": "13.24",
"name": "eVouchers > Fashion"
},
{
"code": "13.25",
"name": "eVouchers > Food & Restaurant"
},
{
"code": "13.26",
"name": "eVouchers > Gaming"
},
{
"code": "13.27",
"name": "eVouchers > Grocery"
},
{
"code": "13.28",
"name": "eVouchers > Healthcare"
},
{
"code": "13.29",
"name": "eVouchers > Home & Living"
},
{
"code": "13.31",
"name": "eVouchers > Insurance"
},
{
"code": "13.32",
"name": "eVouchers > Movies"
},
{
"code": "13.33",
"name": "eVouchers > Music"
},
{
"code": "13.34",
"name": "eVouchers > Office"
},
{
"code": "13.35",
"name": "eVouchers > Religious"
},
{
"code": "13.36",
"name": "eVouchers > Software"
},
{
"code": "13.37",
"name": "eVouchers > Subscriptions"
},
{
"code": "13.38",
"name": "eVouchers > Wellness & Sports"
},
{
"code": "13.39",
"name": "eVouchers > Beauty"
},
{
"code": "13.41",
"name": "eVouchers > Cafes & Restaurants"
},
{
"code": "13.42",
"name": "eVouchers > Electronics"
},
{
"code": "13.43",
"name": "eVouchers > Fueling Stations"
},
{
"code": "13.44",
"name": "eVouchers > Furniture Store"
},
{
"code": "13.45",
"name": "eVouchers > Others"
},
{
"code": "13.46",
"name": "eVouchers > Pharmacies"
},
{
"code": "13.47",
"name": "eVouchers > Retail Outlets"
},
{
"code": "13.48",
"name": "eVouchers > Schools"
},
{
"code": "13.49",
"name": "eVouchers > Supermarkets"
},
{
"code": "13.51",
"name": "eVouchers > Health and Beauty"
},
{
"code": "13.52",
"name": "eVouchers > Beauty & Personal Care"
},
{
"code": "13.53",
"name": "eVouchers > Hotels"
},
{
"code": "13.54",
"name": "eVouchers > Books"
},
{
"code": "13.55",
"name": "eVouchers > Tours and Travel"
}
]
}
}Category Structure
Some categories are provided as parent categories, while others are more specific subcategories.
For example:
Mobile Data
├── Daily Bundles
├── 7-14 Day Bundles
├── Monthly Bundles
├── Extended Validity Bundles
├── Special Offers
└── SME Data Share BundlesSimilarly, Utilities and Taxes contain more specific subcategories:
Utilities
├── Electricity
├── Water
└── Transport & Toll Payment
Taxes
├── Federal
└── StateThe category code should be used when an API endpoint requires a product category identifier.
Updated 26 days ago
Did this page help you?