---
title: "Get BBPS Categories API Reference"
description: "Retrieve the list of supported BBPS biller categories (electricity, gas, DTH, etc.)."
canonical: "https://eps.eko.in/docs/bbps-get-categories"
---


> **Canonical URL:** https://eps.eko.in/docs/bbps-get-categories
> This is a machine-readable Markdown version of the page for AI agents and LLMs. The primary (HTML) version lives at the canonical URL above.

# Get BBPS Categories API Reference

`GET https://staging.eko.in/ekoapi/v3/customer/payment/bbps/categories`

Retrieve the list of supported BBPS biller categories (electricity, gas, DTH, etc.).

Returns all active biller categories available on the BBPS network. Use the returned category_id to filter the Get Operators call. Categories include electricity, gas, water, DTH, broadband, prepaid recharge, FASTag, insurance, EMI payments, LPG booking, credit card, and more.

> View product & pricing details: [Bharat Bill Payment System (BBPS)](https://eps.eko.in/products/bbps-api.md)

## Query parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| initiator_id | string | yes | Registered mobile number of the API user (see Platform Credentials). e.g. 9962981729 |
| user_code | string | yes | User code of the retailer/agent the service is run for. e.g. 20810200 |

## Headers

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| developer_key | string | yes | Static API key issued to your account after KYC. |
| secret-key | string | yes | Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))). |
| secret-key-timestamp | string | yes | Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time. |
| content-type | string | yes | application/json e.g. application/json |

## Response

⭐ marks fields highlighted as verifiable.

| Field | Type | Description |
| --- | --- | --- |
| status | number | Primary success indicator (0 = success). |
| message | string | Human-readable response / error message. |
| response_status_id | number | Granular status id; see the shared error-codes table. |
| response_type_id | number | A unique id for every possible response shape (success or error) — useful for client logic branching and analytics. |
| data | object | API-specific response payload. |
| data.categories ⭐ | array | List of all supported BBPS biller categories. |
| data.categories.id ⭐ | number | Unique category identifier (category_id). Pass as the `category` query param when filtering operators. |
| data.categories.category_name ⭐ | string | Human-readable category label. |

## Example response

```json
{
  "status": 0,
  "response_status_id": 0,
  "message": "Success",
  "response_type_id": 1388,
  "data": {
    "categories": [
      {
        "id": 1,
        "category_name": "Prepaid"
      },
      {
        "id": 2,
        "category_name": "DTH"
      },
      {
        "id": 4,
        "category_name": "Postpaid"
      },
      {
        "id": 5,
        "category_name": "Electricity"
      },
      {
        "id": 6,
        "category_name": "Gas"
      },
      {
        "id": 7,
        "category_name": "Water"
      },
      {
        "id": 8,
        "category_name": "Broadband"
      },
      {
        "id": 9,
        "category_name": "Landline"
      },
      {
        "id": 10,
        "category_name": "Insurance"
      },
      {
        "id": 11,
        "category_name": "FASTag"
      },
      {
        "id": 12,
        "category_name": "LPG Booking"
      },
      {
        "id": 13,
        "category_name": "EMI Payments"
      },
      {
        "id": 14,
        "category_name": "Credit Card"
      },
      {
        "id": 15,
        "category_name": "Education"
      },
      {
        "id": 16,
        "category_name": "Metro"
      },
      {
        "id": 17,
        "category_name": "Municipal Corp"
      }
    ]
  }
}
```