Biller List

POST

https://api.formaxpay.com/api/bbps/v3/biller_list

This API is used to fetch the list of BBPS billers/operators based on a selected category (e.g., Postpaid, Electricity, Gas, Broadband). It also provides details about bill fetch requirements and input parameters needed for bill payment.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.formaxpay.com/api/bbps/v3/biller_list' \
--header 'Authorization: Basic aXlrdmN4TTNVRjJoNmFwREJncWhGWFRDaUxMZ0hPVVk6cE9rZCE7ZGNVUjU3MDFjOw==' \
--header 'Content-Type: application/json' \
--data '{
    "category": "Electricity"
}'

Response Example

{
    "status": "SUCCESS",
    "message": "SUCCESS",
    "data": [
        {
            "id": 11,
            "operator_id": "31",
            "biller_name": "Adani Electricity Mumbai Limited",
            "biller_id": "RELI00000MUM03",
            "category": "Electricity",
            "bbps_enabled": true,
            "bill_fetch_required": "Required",
            "circle_id": "0",
            "amount_exactness": "Exact",
            "payment_channel": "AGT",
            "payment_modes": [
                "Cash",
                "Credit Card",
                "Debit Card",
                "Internet Banking",
                "UPI",
                "Wallet"
            ],
            "int_channel_min_in_paisa": 100,
            "int_channel_max_in_paisa": 1000000000,
            "cash_min_in_paisa": 100,
            "cash_max_in_paisa": 4999900,
            "creditcard_min_in_paisa": 100,
            "creditcard_max_in_paisa": 1000000000,
            "debitcard_min_in_paisa": 100,
            "debitcard_max_in_paisa": 1000000000,
            "internetbanking_min_in_paisa": 100,
            "internetbanking_max_in_paisa": 1000000000,
            "upi_min_in_paisa": 100,
            "upi_max_in_paisa": 1000000000,
            "wallet_min_in_paisa": 100,
            "wallet_max_in_paisa": 20000000,
            "params": [
                {
                    "name": "Consumer number",
                    "id": "cn",
                    "regex": "^[0-9]{9}$",
                    "optional": true,
                    "payment_id": "cn"
                }
            ]
        },
        {
            "id": 1356,
            "operator_id": "1893",
            "biller_name": "AEML SEEPZ Limited",
            "biller_id": "AEML00000NATD1",
            "category": "Electricity",
            "bbps_enabled": true,
            "bill_fetch_required": "Required",
            "circle_id": "0",
            "amount_exactness": "Exact",
            "payment_channel": "AGT",
            "payment_modes": [
                "Cash",
                "Credit Card",
                "Debit Card",
                "Internet Banking",
                "UPI",
                "Wallet"
            ],
            "int_channel_min_in_paisa": 100,
            "int_channel_max_in_paisa": 1000000000,
            "cash_min_in_paisa": 100,
            "cash_max_in_paisa": 10000000000,
            "creditcard_min_in_paisa": 100,
            "creditcard_max_in_paisa": 10000000000,
            "debitcard_min_in_paisa": 100,
            "debitcard_max_in_paisa": 10000000000,
            "internetbanking_min_in_paisa": 100,
            "internetbanking_max_in_paisa": 10000000000,
            "upi_min_in_paisa": 100,
            "upi_max_in_paisa": 10000000000,
            "wallet_min_in_paisa": 100,
            "wallet_max_in_paisa": 10000000000,
            "params": [
                {
                    "name": "Consumer number",
                    "id": "cn",
                    "regex": "^(6|39|59|48|49){1,2}[0-9]{7,8}",
                    "optional": true,
                    "payment_id": "cn"
                }
            ]
        },
        {
            "id": 47,
            "operator_id": "132",
            "biller_name": "Ajmer Vidyut Vitran Nigam Limited (AVVNL)",
            "biller_id": "AVVNL0000RAJ01",
            "category": "Electricity",
            "bbps_enabled": true,
            "bill_fetch_required": "Required",
            "circle_id": "0",
            "amount_exactness": "Exact",
            "payment_channel": "AGT",
            "payment_modes": [
                "Cash",
                "Credit Card",
                "Debit Card",
                "Internet Banking",
                "UPI",
                "Wallet"
            ],
            "int_channel_min_in_paisa": 100,
            "int_channel_max_in_paisa": 500000000,
            "cash_min_in_paisa": 1,
            "cash_max_in_paisa": 0,
            "creditcard_min_in_paisa": 1,
            "creditcard_max_in_paisa": 0,
            "debitcard_min_in_paisa": 1,
            "debitcard_max_in_paisa": 0,
            "internetbanking_min_in_paisa": 1,
            "internetbanking_max_in_paisa": 0,
            "upi_min_in_paisa": 1,
            "upi_max_in_paisa": 0,
            "wallet_min_in_paisa": 1,
            "wallet_max_in_paisa": 20000000,
            "params": [
                {
                    "name": "K Number",
                    "id": "cn",
                    "regex": "^[0-9]{12}$",
                    "optional": true,
                    "payment_id": "cn"
                }
            ]
        },
        {
            "id": 1098,
            "operator_id": "1562",
            "biller_name": "Andhra Pradesh Central Power Distribution Corporation Limited",
            "biller_id": "ANDH00000ANPAO",
            "ca

Modified at 2026-07-30 16:01:14

Category List

Bill Fetch