Bill payment screens work best when the customer does not have to type an amount. A bill fetch asks the biller for the current due amount using an identifier the customer already knows. We support three families: electricity boards, postpaid and landline operators, and FASTag issuers.
The three endpoints
| Endpoint | Identifier | Coverage |
|---|---|---|
electricityBillFetch | Consumer or bill number (billnumber) | 70+ electricity boards |
postpaidBillFetch | Mobile or account number (mobileno) | Major postpaid and landline operators |
fastagBillFetch | Vehicle number (vehicleno) | Leading FASTag issuers |
All of them also take your username, pwd and an operatorcode from the free Operator Code List.
Example
GET /planapi/electricityBillFetch?username=YOUR_ID&pwd=YOUR_PWD
&operatorcode=TNEB&billnumber=050090221445Some boards need extra data such as a date of birth or district. Pass it in optional1, optional2 and optional3; the board decides which one it expects.
Reading the response
A success has "ERROR": "0" and a BILLDEATILS object (the key is spelled this way by the upstream provider, so parse it exactly) with the customer name, due amount, due date and bill date. Always show the name to the customer before they pay, so a mistyped number is caught.
How billing works
- Bill fetch does not use your daily plan hits.
- A small per-fetch charge is deducted from your wallet, and only when the lookup succeeds.
- Every deduction appears in your wallet statement and API hit log.
- If the wallet balance is too low, the call returns a clear message and nothing is charged.
Keep a healthy wallet balance and add funds from your dashboard. Questions about a specific board? Ask us.
Frequently asked questions
Are bill fetches part of my daily plan limit?
No. Bill fetch runs on a separate track and is charged per successful fetch from your wallet, not from your daily hits.
Am I charged when the bill is not found?
No. The wallet is charged only when the lookup succeeds.
Ready to build?
Create an account, pick a plan and make your first call today. Every plan includes every endpoint.
Create account Read the docs
