Fetch Bill

Fetch Bill

Postman Collection

BBPS

URL

POST : /v1/service/bbps/quickbill/fetch/bill

Headers

Content-Type  (String)   required
application/json

Authorization  (String)   required
Basic Auth

Accept  (String)   required
application/json

Body Params

billerId  (String)   Required
Merchant biller Id (Max Length: 50)

customerMobileNo  (String)   Required
Merchant Mobile No (Max Length: 10)

customerEmail  (String)   Required
Customer email Id (Max Length: 50)

customerAadhaar  (String)   Optional
Customer Aadhaar Id (Max Length: 50)

customerPan  (String)   Optional
Customer Pan Id (Max Length: 50)

customerParamsRequest  (object)   Required
Customer Request Parameter (Max Length: 5000)

Request

Example Request

    curl --location --request POST '/v1/service/bbps/quickbill/fetch/bill' \
        --header 'Content-Type: application/json' \
        --header 'Authorization: Basic Og==' \
        --data '{
        "billerId": "UPPC00000UTPAH",
        "customerMobileNo": "XXXXX7986",
        "customerEmail": "kumaxxxxx@gmail.com",
        "customerAadhaar": "",
        "customerPan": "",
        "customerParamsRequest": {
            "tags": [
                {
                    "name": "Consumer Number",
                    "value": "99999999"
                },
                {
                    "name": "District-Discom",
                    "value": "Ayodhya-MVVNL"
                }
            ]
        }
    }'

Response Samples

SUCCESS

   {
        "code": "0x0200",
        "message": "Record fetched successfully.",
        "status": "SUCCESS",
        "data": {
            "amount": 100,
            "billId": "BILL5632112345678818224XXXXXXXXXXX",
            "refId": "BILL5632112345678818224XXXXXXXXXXX",
            "billerId": "UPPC00000UTPAH",
            "status": "BILL_FETCH_SUCCESS",
            "userId": "",
            "billDate": "2025-09-04",
            "billNumber": "823398XXXX",
            "billPeriod": "NA",
            "custConvFee": 0,
            "couCustConvFee": 0,
            "dueDate": "2025-09-18",
            "customerName": "Name ",
            "amountOption": null,
            "additionalInfo": null,
            "customerParams": {
                "tags": [
                    {
                        "name": "Consumer Number",
                        "value": "82361XXXX"
                    },
                    {
                        "name": "District-Discom",
                        "value": "Ayodhya-MVVNL"
                    }
                ]
            },
        "billerResponseList": {
                "billAmount": "13500",
                "billDate": "2025-09-04",
                "billNumber": "82339852XXX",
                "billPeriod": "MONTHLY",
                "customerName": "Name",
                "dueDate": "2025-09-18"
            }
        }
    }

FAILED

    {
        "code": "0x0202",
        "status": "FAILURE",
        "message": "No Record found",
        "data": "Please use valid billerId"
    }

Response Code

Status Code	Status	Message
0x0200	SUCCESS	TRANSACTION SUCCESSFULL
0x0201	UNAUTHORIZED	UNAUTHORIZED USER
0x0202	FAILURE	FAILURE USER
0x0203	MISSING_PARAMETER	MISSING PARAMETER
0x0204	CONNECTION_TIMEOUT	CONNECTION TIMEOUT
0x0205	SOMETHING_WENT_WRONG	SOMETHING WENT WRONG
0x0206	PENDING	TRANSACTION PENDING
0x0207	REVERSED	TRANSACTION REVERSED
0x0209	REDIRECT	REDIRECT URL