Fetch Bill by BillId

Fetch Bill by BillId

Postman Collection

BBPS

URL

GET : /v1/service/bbps/fetch/billByBillId

Headers

Content-Type  (String)   required
application/json

Authorization  (String)   required
Basic Auth

Accept  (String)   required
application/json

Body Params

billId  (String)   Required
Merchant Bill Id (Max Length: 50)

Request

Example Request

    curl --location --request GET '/v1/service/bbps/fetch/billByBillId' \
        --header 'Content-Type: application/json' \
        --header 'Authorization: Basic Og==' \
        --data '{
            "billId": "b140e4d9-XXXX-456a-XXXX-4955c132eee4"
        }'

Response Samples

SUCCESS

    {
    "code": "0x0200",
    "message": "Record fetched successfully.",
    "status": "SUCCESS",
    "data": {
        "billerResponse": {
            "amount": 363.1,
            "billId": "aabb325f-e923-42ea-8da3-1a6d2358f3ex",
            "refId": "NXnlLlWkJbp1MjUYAO3SyWBLXXXXXXX",
            "billerId": "UTTA00000GUJAJ",
            "status": "BILL_FETCH_SUCCESS",
            "userId": "FE41FE15INXXXXXXXXX",
            "billDate": "2025-08-31",
            "billNumber": "1614XXXX",
            "billPeriod": "JUL-AUG,25",
            "custConvFee": "0",
            "couCustConvFee": "0",
            "dueDate": "2025-09-10",
            "customerName": "Name",
            "amountOption": false,
            "additionalInfo": [],
            "customerParams": [
                {
                    "name": "Consumer Number",
                    "value": "21834XXXXXX"
                }
            ],
            "billerResponseList": null
        }
    }
}

FAILED

    {
        "code": "0x0202",
        "status": "FAILURE",
        "message": "Bill Not found with ID",
        "data": {
            "message": "Bill Not found with ID",
            "remarks": "",
            "status": "failure",
            "statusCode": "400"
        }
    }

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