Fetch Current Bill

POST

/api/v2/biller/fetchOrAddBill

📌

Use this API to submit biller details and retrieve the current bill information provided by Bharat Connect System (BBPS).
This allows you to obtain up-to-date billing data for a customer, enabling accurate payment processing and streamlined bill management.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

Example

{
    "billerId": 0,
    "circle": "AP",
    "billParams": {
        "cn": "string",
        "ad1": "string",
        "ad2": "string"
    },
    "remarks": "string",
    "keyContactEmail": "string"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test.your-api-server.com/api/v2/biller/fetchOrAddBill' \
--header 'Content-Type: application/json' \
--data-raw '{
    "billerId": 0,
    "circle": "AP",
    "billParams": {
        "cn": "string",
        "ad1": "string",
        "ad2": "string"
    },
    "remarks": "string",
    "keyContactEmail": "string"
}'

Responses

🟢200OK

application/json

Body

Example

{
    "response_code": 0,
    "response_message": "string",
    "payload": {
        "companyBillerId": "string",
        "billNumber": "string",
        "billAmount": 0,
        "billdate": "2025-06-02",
        "dueDate": "2025-06-02",
        "billPeriod": "string",
        "billnetamount": 0,
        "maxBillAmount": 0,
        "minBillAmount": 0,
        "earlyPaymentAmount": 0,
        "earlyPaymentDate": "2025-06-02",
        "latePaymentAmount": 0,
        "actualDueDate": "2025-06-02",
        "statusMessage": "string",
        "billId": "string",
        "billStartDate": "2025-06-02",
        "billEnddate": "2025-06-02",
        "utilityEnkashId": "string",
        "referenceId": "string",
        "billParams": {
            "cn": "string",
            "ad1": "string",
            "ad2": "string"
        }
    }
}

Modified at 2025-07-08 19:52:05

Generate Authentication Token

Fetch Biller List