Get Categories

GET /v1/api/bills/categories

This endpoint is used to retrieve the list of available bill categories.

Parameters

Field	Mandatory	Parameter Type	Data Type	Description
api-key	Yes	Header	String	The client’s API key
secret	Yes	Header	String	The client's secret key for the environment to which the request is being made

Sample Request

curl --location '{BASE_URL}/v1/api/bills/categories' \--header 'secret: {SECRET_KEY}' \--header 'api-key: {API_KEY}'

Sample Response

{
    "status": "SUCCESS",
    "message": "Success fetching bill categories",
    "statusCode": "00",
    "data": [
          {
            "id": "4df26521-26c5-4e96-b70f-fe57907e2146",
            "name": "Electricity",
            "description": "Pay for your Electricity/Bills",
            "imageUrl": "https://storage.googleapis.com/afl_public_bucket/afl-images/category_electricity.svg",
            "isActive": true
        },
        {
            "id": "9fb912a5-3d1a-486f-911e-fe0f36d6c4bd",
            "name": "Television",
            "description": "Dstv, Cable and more",
            "imageUrl": "https://storage.googleapis.com/afl_public_bucket/afl-images/category_television.svg",
            "isActive": true
        },
        {
            "id": "0fa85cb0-8c1c-4444-896f-c94c2af5770d",
            "name": "Airtime",
            "description": "Airtime purchase",
            "imageUrl": "https://raw.githubusercontent.com/omob/ayo.github.io/0318494a6a9473837277fffb3ea2ae87985ef391/assets/Internet_Icon.svg",
            "isActive": true
        },
        {
            "id": "54e48231-5fa8-4e70-a2a8-d4e98079e5bb",
            "name": "Religious Institutions",
            "description": "Religious Institutions",
            "imageUrl": "https://storage.googleapis.com/afl_public_bucket/afl-images/vendor_buyPower.svg",
            "isActive": true
        },
        {
            "id": "7fcc19dd-e663-43d4-840b-f493767ecd8a",
            "name": "Taxes,Internal and Inland Revenue",
            "description": "Taxes, Internal and Inland Revenue",
            "imageUrl": "https://storage.googleapis.com/afl_public_bucket/afl-images/vendor_buyPower.svg",
            "isActive": true
        },
        {
            "id": "013373ba-833f-46f1-9c68-92f2d426f50e",
            "name": "Government Payments",
            "description": "Government Payments",
            "imageUrl": "https://storage.googleapis.com/afl_public_bucket/afl-images/vendor_buyPower.svg",
            "isActive": true
        }
     ]
}