Bill Status Inquiry API
The Bill Status Inquiry API allows businesses to fetch real-time bill details across multiple utility services like electricity, water, gas, and DTH. Designed for high performance and seamless integration, this API enables instant bill validation before payment, reducing failures and improving user experience.
Biller
CESC Limited
Bill Information Found
Customer Name
SUTAPA PAL DATTA
Due Date
15 Apr 2026
Net Payable
₹2,450.00
"status": "SUCCESS"
"amount": "2450.00"
"billerRef": "CESC_330192"
"validation": "CHECKSUM_OK"
Gateway: NPCI-BBPS-PROD-01
Real-Time Bill Status & Payment Tracking
Track payment lifecycles from initiation to final settlement. Eliminate uncertainty with instant status updates.
1. Send Request
Submit the unique Transaction Reference or Bill ID to the inquiry endpoint.
2. Instant Lookup
Our API checks the biller’s central clearinghouse for the latest processing state.
3. Get Status
Receive detailed response: Pending, Success, Failed, or Refunded.
Why Use Bill Enquiry API?
Reduce customer support overhead and provide transparency by giving users a window into their payment journey.
Multi-Biller Access
Real-time bill status from multiple billers ensuring accurate data retrieval across various service points.
Universal Support
Supports Electricity, DTH, Water, Gas & more utility categories through a single integration.
High-Precision Performance
High success rate with accurate data lookups and fast API response times of less than 2 seconds.
Secure & Simple Integration
Secure & encrypted transactions with easy REST API integration for your development team.
Transactional Efficiency
Reduces failed transactions by validating data upfront before payment initiation.
Enterprise Scalability
Scalable for startups to enterprises, built to handle high volumes of concurrent requests.
Advanced Tracking for Bill Status
IDSPay’s Bill Status Enquiry API provides end-to-end visibility into the payment lifecycle, ensuring every transaction is accounted for.
Instant Transaction Audit
Query the real-time status of any bill payment request. Confirm instantly whether a transaction is successful, pending, or failed.
Biller Acknowledgment
Receive verified confirmation from the biller's system. Ensure funds have been correctly credited to the specific consumer account.
Reconciliation Alerts
Identify and resolve payment discrepancies automatically. Track refunds and reversals to keep your financial ledgers perfectly balanced.
Critical for Payment Assurance
Verifying payment status is the final bridge in the fintech journey. IDSPay provides the automated enquiry tools needed to eliminate double-payments, resolve user disputes, and provide definitive proof of transaction completion for every stakeholder.
🔐 Key Features of Bill Status Enquiry API
Track payment lifecycles and verify transaction finality with a high-speed API designed for real-time reconciliation and status confirmation.
Real-Time Status
Instantly retrieve the current state of any bill payment from "Pending" to "Settled."
Biller Reference
Obtain official operator IDs and biller-generated receipt numbers for customer proof.
Auto-Reconciliation
Automate your backend ledger updates by matching enquiry responses with transaction IDs.
Secure Handshake
Each status check is protected by enterprise-grade authentication and secure API protocols.
Detailed Response
Get specific failure reasons (e.g., account mismatch) to assist users with retry attempts.
Sub-Second Latency
Optimized architecture ensures status lookups respond in milliseconds for a smooth UI.
Dispute Resolution
Direct access to status data empowers your support teams to resolve ticket inquiries instantly.
Omnichannel Sync
Maintain consistent transaction status across web, mobile, and agent-led payment channels.
How Status Enquiry Works
Track any bill payment from the moment it’s initiated until it reaches the biller's ledger.
Initiate Lookup
Pass the Transaction ID or Biller Reference Number through our secure endpoint.
Verification Flow
The API communicates with the NPCI/BBPS switch or direct biller node for updates.
Data Processing
Our system parses the raw response to extract settlement codes and reference numbers.
Final Status
The final status is returned to your dashboard, triggering the completion of the user journey.
Why IDSPay is Better than Other Bill Details fetch APIs?
See how we outperform the industry standards for biller data.
Dynamic Updates
Real-time sync ensures you always have the latest BBPS and private billers.
Deep Metadata
Includes operator logos, validation regex, and specific consumer parameters.
Category Logic
Smart categorization for electricity, gas, water, and insurance billers.
Scalable Pricing
Cost-efficient API plans tailored for growing fintech applications.
Expert Integration
24/7 technical support to assist with mapping complex BBPS biller parameters and webhooks.
Integrate Status Enquiry in Minutes
Verify payment finality and retrieve biller reference IDs effortlessly. Fully documented SDKs for Node.js, PHP, Python, and Java.
curl --request POST \
--url "https://api.idspay.in/v3/billers/check-status" \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"client_ref_id": "TXN_9921045",
"agent_id": "IDS_8821",
"service_type": "BILL_PAY"
}'{
"status": "SUCCESS",
"data": {
"payment_status": "SETTLED",
"operator_ref": "BBS992102341",
"txn_time": "2026-04-10 12:30:15",
"biller_name": "BSES Yamuna",
"amount_paid": "1450.50",
"reconciled": true
}
}Why We Are The Better Choice
Compare our performance and see why top fintechs trust our infrastructure.
| Feature | 🚀 Our API | Other Providers |
|---|---|---|
| Accuracy |
99.9% (Govt. Direct)
|
~85-90% (Scraped)
|
| Speed |
< 500ms
|
2 - 5 Seconds
|
| Pricing |
Pay-per-use (No Fixed Fee)
|
High Monthly Commitment
|
| Support |
24/7 Priority Support
|
Email-only (48hr TAT)
|
* Based on internal benchmark tests and competitor analysis (April 2026).
Frequently Asked Questions
Common developer queries about integrating the Bill Status Enquiry API.
1. What is the Bill Status Enquiry API?
This API allows you to check the definitive status of a bill payment transaction. It confirms whether a payment is pending, successful, or failed at the biller's end using a transaction reference or operator ID.
2. When should I use the Status Enquiry API?
It is best used for real-time reconciliation, handling "Pending" transactions, or when a customer disputes a payment status. It provides a final confirmation beyond your internal database.
3. What details do I need to query a status?
You typically need the unique Transaction Reference ID (client_ref_id) or the Biller/Operator Reference ID generated during the initial payment request.
4. Does the API provide the Operator Reference Number?
Yes, once a transaction is successful, the API returns the official Biller/BBPS Reference Number, which can be used by the customer to verify the payment with the utility provider.
5. How often can I poll for a transaction status?
We recommend an exponential backoff strategy for polling. Typically, status updates are available within seconds, but some billers may take longer for final settlement.
6. Does it return the reason for a payment failure?
Yes, the API response includes a "remark" or "reason" field that specifies why a biller rejected the payment, such as "Invalid Account," "Payment already made," or "Biller system down."
7. Is the status enquiry API secure?
Absolutely. The API requires Bearer Token authentication and uses SSL/TLS encryption for all data transfers, ensuring that transaction details are never exposed to unauthorized parties.
8. Can I check the status of old transactions?
Yes, the API supports historical status lookups for a specific period (usually up to 90 days), allowing you to audit and reconcile past payments.
9. What is the typical uptime for this API?
Our API gateway maintains a 99.9% uptime. However, since we query billers directly, results are subject to the availability of the specific biller's backend systems.
10. How do I distinguish between internal and biller success?
The API response provides distinct flags: one for our gateway's processing status and another for the Biller's acknowledgment (Operator Status), providing total transparency.