Get Categories

Retrieves a list of all available product categories and subcategories supported by LedgerBlock. Each category includes a unique code and name that can be used to identify the type of product being accessed.

Request

Method: GET

Endpoint:

{{base_url}}/api/v1/utility/categories

Authentication & Headers

Header	Type	Required	Description
`Authorization`	String	Yes	`Bearer ${api_key}` — your activated merchant API key.
`x-merchant-ref`	String	Yes	Your unique merchant reference.

Request Body

This endpoint does not require a request body.

Response

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

Response Fields

Field	Type	Description
`status`	String	Indicates whether the request was successful.
`message`	String	Response message.
`data.data`	Array	List of available product categories and subcategories.
`code`	String	Unique code assigned to the category or subcategory.
`name`	String	Name of the product category or subcategory.

This is the format I’d keep for the rest of the Utility API endpoints as well.