Bill Status Enquiry API
Check the status of a bill payment transaction.
Request
Response{ "error": false, "status": "SUCCESS", "data": { "bill_amount_and_due_date": "…", "payment_reference_and_status": "…" }}
Illustrative example. Exact parameters are listed in your dashboard docs.
How it works
What you send and what you get back
Fetch and pay utility bills for electricity, gas, water, broadband and more, with operator discovery and payment status tracking.
You send
- Biller / operator
- Customer account number
You get back
- Bill amount and due date
- Payment reference and status
Why Shadoweye
Built for production from day one
Real-time results
Responses come back in milliseconds, so the check fits inline in your signup or approval flow.
Clean, consistent JSON
Every Shadoweye API returns the same response envelope. Parse it once and reuse it everywhere.
One key for every API
Use the same API key for the Bill Status Enquiry API and every other API in the catalogue. No extra contracts.
Pay per call
Calls are charged from your prepaid wallet. No monthly fee and no minimum commitment.
Secure by default
All traffic runs over HTTPS and every request is authenticated with your secret key.
Full audit trail
Every call and deduction is recorded in your dashboard ledger for reconciliation and audits.
Use cases
Where teams use the Bill Status Enquiry API
Payment apps
Let users pay all their bills in one place.
Retail counters
Collect bill payments through agents.
Reminders
Fetch due bills and notify customers.
Corporate payments
Pay office utility bills programmatically.
Get started
Go live in four steps
Create your account
Sign up and get a live API key from your Shadoweye dashboard.
Add funds
Top up your prepaid wallet securely with UPI, card or net banking.
Test it live
Try the Bill Status Enquiry API with real data in the Live Tester before you write code.
Call the API
Send a POST request with your key in the X-Shadoweye-Api-Key header and use the JSON response.
FAQ
Frequently asked questions
What is the Bill Status Enquiry API?
Check the status of a bill payment transaction. It is part of the Shadoweye Bill Payment API family and is available through a single REST API key.
What do I need to send to the Bill Status Enquiry API?
Typical inputs are: Biller / operator; Customer account number. The exact parameters for this API are listed in your dashboard documentation.
What does the Bill Status Enquiry API return?
You receive a JSON response that typically includes: Bill amount and due date; Payment reference and status.
How much does the Bill Status Enquiry API cost?
Calls are charged per request from your prepaid Shadoweye wallet at the rate shown in your dashboard. There are no monthly fees or minimum commitments.
How do I get started?
Create a free account, add funds to your wallet, copy your API key and test the API in the Live Tester. Most teams go live the same day.
Is my data secure?
All requests use HTTPS, are authenticated with your secret API key and are recorded in your audit ledger. Only send personal data you are permitted to process, with the customer's consent where required.
Related Bill Payment API
View allBill Payment Operator List
Get the list of supported billers by category and region.
Fetch Bill Details
Fetch the outstanding bill amount and due date for a customer account.
Pay Bill
Pay a utility bill and receive the biller's payment reference.
