Fetch Biller List

💡

This API allows you to retrieve a list of billers supported by BBPS.
It accepts two optional parameters:

billerType: Returns the list of billers for a specific category (for example, electricity, water, telecom).

stateCode: Returns the list of billers available for a specific state code.

Note:
If both billerType and stateCode are not provided, the API will return all supported billers, which may result in a very large response payload. It is recommended to use at least one of these parameters to narrow down the results and optimize performance.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

billerType

enum<string>

optional

Allowed values:

ELECTRICITYGASWATERBROADBANDINSURANCEDTHPREPAIDLANDLINEPOSTPAIDDATACARDDATACARD_BPEMIFASTagMUNICIPALITYLPG_BOOKINGCABLE_TVCLUBS_ASSOCIATIONSCREDIT_CARDEDUCATION_FEESHEALTH_INSURANCEHOSPITAL_PATHOLOGYHOUSING_SOCIETYLIFE_INSURANCELOAN_REPAYMENTMUNICIPAL_SERVICESMUNICIPAL_TAXESRECURRING_DEPOSITSUBSCRIPTIONOTHERS

stateCode

enum<string>

optional

Allowed values:

AndhraPradeshArunachalPradeshAssamBiharChattisgarhGoaGujaratHaryanaHimachalPradeshJammuAndKashmirJharkhandKarnatakaKeralaMadhyaPradeshMaharashtraManipurMeghalayaMizoramNagalandOrissaPunjabRajasthanSikkimTamilNaduTelanganaTripuraUttarakhandUttarPradeshWestBengalAndamanAndNicobarChandigarhDadraandNagarHaveliDamanAndDiuDelhiLakshadweepPondicherryINVALID_STATE_CODE

Responses

🟢200OK

application/json

Body

response_code

integer <int32>

optional

response_message

string

optional

payload

array[object (BillerV2Response) {10}]

optional

billerId

integer

required

name

string

required

billerType

string

required

partialPayAllowed

boolean

required

inputParams

array [object {7}]

required

circleParams

array [object {2}]

required

paymentAmountExactness

string

required

state

string

required

circleStateMapping

object

required

viewBillSupported

boolean

required

Example

{
    "response_code": 0,
    "response_message": "Success",
    "payload": [
        {
            "billerId": 12345,
            "name": "Electricity Company XYZ",
            "billerType": "ELECTRICITY",
            "inputParams": [
                {
                    "paramKey": "cn",
                    "paramName": "Consumer ID",
                    "paramType": "NUMBER",
                    "paramRegex": "^[0-9]{10}$",
                    "invalidParamError": "Consumer ID must be a 10-digit number",
                    "mandatory": true,
                    "paramValues": []
                },
                {
                    "paramKey": "ad1",
                    "paramName": "Billing Month",
                    "paramType": "NUMBER",
                    "paramRegex": "^(0?[1-9]|1[0-2])$",
                    "invalidParamError": "Please enter a valid month (1-12)",
                    "mandatory": true,
                    "paramValues": [
                        {
                            "key": "1",
                            "value": "January"
                        },
                        {
                            "key": "2",
                            "value": "February"
                        },
                        {
                            "key": "3",
                            "value": "March"
                        }
                    ]
                }
            ],
            "circleParams": [
                {
                    "key": "circle",
                    "value": "AP"
                },
                {
                    "key": "region",
                    "value": "South"
                }
            ],
            "paymentAmountExactness": "EXACT",
            "state": "ANDAMAN_AND_NICOBAR_ISLANDS",
            "circleStateMapping": {
                "AP": "ANDAMAN_AND_NICOBAR_ISLANDS"
            },
            "viewBillSupported": true
        }
    ]
}

Request

Request samples

Responses