GETGet BBPS Operators

List all active BBPS billers, optionally filtered by category and/or state.

GET/customer/payment/bbps/operators

Returns the list of billers. Filter by category, location, or both, using the identifiers from Get Categories and Get Locations; omit both to list every biller.

The operator_id returned here is what you pass as phone_operator_code to Fetch Bill and Pay Bill — the names differ. billFetchResponse tells you whether the biller supports a live bill fetch. The list is returned under param_attributes.list_elements, not under data.

Tip

This endpoint is one step in a complete workflow:

BBPS — Pay a Utility Bill — Pick a biller by category, read the fields it requires, fetch the live bill, then pay the exact amount. Get Locations is an optional extra filter on the biller list, and UPPCL (operator 190) additionally needs a district_discome from Get District Discome — neither is a step here because neither applies to every biller.

Request

Query parameters

Field	Type	Required	Description
`initiator_id`	string	required	Registered mobile number of the API user (see Platform Credentials).e.g. 9962981729
`client_ref_id`	string	optional	Unique reference ID per API call, generated by your system (max 20 characters).e.g. 2026010100123456789
`category`	number	optional	Filter by category — the `operator_category_id` from Get Categories.e.g. 11
`location`	number	optional	Filter by state / UT — the `operator_location_id` from Get Locations.e.g. 35

initiator_idstringRequired

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

example: 9962981729

client_ref_idstringoptional

Unique reference ID per API call, generated by your system (max 20 characters).

example: 2026010100123456789

categorynumberoptional

Filter by category — the `operator_category_id` from Get Categories.

example: 11

locationnumberoptional

Filter by state / UT — the `operator_location_id` from Get Locations.

example: 35

These headers authenticate and sign every request. See How Auth Works for details.

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

Response types

response_type_id	Meaning	Next step
`2461`	Biller list returned — read the chosen operator's input fields next.	Get Operator Parameters

Responses

2461Biller list returned — read the chosen operator's input fields next.Next:Get Operator Parameters

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.
- param_attributesobject
  Wrapper for the biller list — returned at the top level of the response, not under `data`.
  - list_elementsarray
    One entry per biller matching the filters.
    - operator_idnumber
      Biller identifier. Pass as `phone_operator_code` to Fetch Bill and Pay Bill.
    - namestring
      Biller name.
    - operator_categorynumber
      Category this operator belongs to.
    - location_idnumber
      Location this operator serves; `0` = pan-India.
    - kyc_requirednumber
      Whether customer KYC is required for this operator.
    - billFetchResponsenumber
      Whether the operator supports live bill fetch (`1` = yes).
    - high_commission_channelnumber
      Whether the biller is available on the higher-commission channel.

Next steps

NextGETGet Operator ParametersFetch the custom input fields required by a specific biller before payment.

Request

Query parameters

Response types

Responses

Next steps

Related