GETGet BBPS Operators

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

GET/customer/payment/bbps/operators

Returns every currently active BBPS biller. Use category and location query parameters to narrow results. The billFetchResponse flag on each operator tells you whether the Fetch Bill step is mandatory before payment. Operators that are temporarily disabled are excluded from the response — poll this endpoint periodically to keep your list fresh.

Query parameters

Field	Type	Required	Description
`initiator_id`	string	required	Registered mobile number of the API user (see Platform Credentials).e.g. 9962981729
`user_code`	string	required	User code of the retailer/agent the service is run for.e.g. 20810200
`category`	number	optional	Filter by category — use the `id` from Get Categories.e.g. 5
`location`	number	optional	Filter by state/circle — use the `id` from Get Locations.e.g. 7

initiator_idstringRequired

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

example: 9962981729

user_codestringRequired

User code of the retailer/agent the service is run for.

example: 20810200

categorynumberoptional

Filter by category — use the `id` from Get Categories.

example: 5

locationnumberoptional

Filter by state/circle — use the `id` from Get Locations.

example: 7

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.
- operatorsarray
  List of active BBPS billers matching the filters.
  - operator_idnumber
    Unique operator identifier. Pass this value in Fetch Bill and Pay Bill requests.
  - operator_namestring
    Display name of the biller.
  - category_idnumber
    Category this operator belongs to.
  - billFetchResponsenumber
    1 = must call Fetch Bill API before Pay Bill; 0 = can pay directly.
  - high_commission_channelnumber
    0 = instant settlement (default); 1 = delayed channel with higher commissions.