GETGet BBPS Categories

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

GET/customer/payment/bbps/categories

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.

Query parameters

Field	Type	Required	Description
`initiator_id`	string	required	Registered mobile number of the API user (see Platform Credentials).e.g. 9962981729

initiator_idstringRequired

Registered mobile number of the API user (see Platform Credentials).

example: 9962981729

Headers

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

developer_keystringRequired

Static API key issued to your account after KYC.

secret-keystringRequired

Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))).

secret-key-timestampstringRequired

Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time.

content-typestringRequired

application/json

example: application/json

Responses

statusnumber
Primary success indicator (0 = success).
messagestring
Human-readable response / error message.
response_status_idnumber
Granular status id; see the shared error-codes table.
response_type_idnumber
A unique id for every possible response shape (success or error) — useful for client logic branching and analytics.
dataobject
API-specific response payload.
- categoriesarray
  List of all supported BBPS biller categories.
  - idnumber
    Unique category identifier (category_id). Pass as the `category` query param when filtering operators.
  - category_namestring
    Human-readable category label.

Next steps

NextGETGet BBPS LocationsRetrieve the list of supported state/location IDs for filtering BBPS operators.

import { EpsClient } from "@ekoindia/eps-sdk";

const client = new EpsClient({

developerKey: process.env.EPS_DEVELOPER_KEY,

accessKey: process.env.EPS_ACCESS_KEY,

initiatorId: "9962981729",

environment: "sandbox",

});

const result = await client.call("bbps-get-categories");

console.log(result);

{

"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"

}

]

}

Query parameters

Headers

Responses

Next steps

Related