Get Installment By Mandate API – Fetch EMI Details Instantly | Fast & Secure API
The Get Installment By Mandate API enables businesses to instantly fetch installment details linked to a specific mandate. Whether you're managing loan repayments, subscription billing, or recurring payments, this API provides real-time access to EMI schedules, payment status, due dates, and transaction history.
AUTOFLOW
E-Mandate APIMaximum Limit
₹ 25,000/cycle
Frequency
MONTHLY
Start Date
17 APR 2026
Status
ACTIVE
HDFC Bank Ltd.
XXXX XXXX 8821
{
"mandate_id": "EM_4409X",
"type": "ON_DEVICE_AUTH",
"config": {
"max_amount": 25000.00,
"recurrence": "MNTH",
"secure_hash": "AES_GCM_256"
}
}
NPCI_ONBOARDED
Digital India Stack 2026
Get Mandate Installment API
Retrieve comprehensive payment schedules and real-time execution logs for any active mandate. Gain full visibility into automated collection cycles, transaction history, and upcoming debit obligations.
1. Identify Mandate
Submit the unique Mandate Reference ID to query the associated payment timeline and scheduled debit instructions.
2. Data Retrieval
Our engine pulls the exact sequence of installments, factoring in frequency, start dates, and maximum debit limits.
3. Actionable Insights
Receive a structured response containing installment IDs, due dates, amounts, and live execution statuses for reconciliation.
Precision Cycle Management
Eliminate billing uncertainty. The Get Installment API delivers the granular data required to automate customer notifications and financial forecasting.
Next-Debit Visibility
Pinpoint the exact upcoming payment date to ensure sufficient balance reminders are sent to your customers.
Dynamic Amount Tracking
Monitor fixed or variable amounts scheduled for each installment to ensure alignment with active service tiers.
Completed vs. Remaining
Easily calculate the remaining balance of a mandate by comparing successful debits against the total installment count.
Historical Audit Logs
Retrieve a comprehensive log of all past attempts, including timestamps and bank-end response codes.
Real-Time Settlements
Track the transition of installments from 'Scheduled' to 'Settled' for instant ledger updates and accounting.
Revenue Projection
Use installment-level data to generate accurate cash-flow forecasts based on contractually obligated payments.
Smart Dispute Handling
Provide support teams with precise installment metadata to resolve customer billing inquiries in seconds.
Automated Renewals
Detect when a mandate reaches its final installment to trigger seamless renewal workflows or re-engagement campaigns.
Regulatory Compliance
Validate that every transaction adheres to the frequency and limit constraints defined during mandate registration.
Enterprise Billing Intelligence
Leverage our specialized endpoints to gain a 360-degree view of your recurring revenue streams and mandate health.
Detailed Schema
Fetch comprehensive attributes including specific installment IDs, cycle counts, and exact debit timestamps.
Transaction Logs
Access deep-link logs for every installment to monitor success rates and identify collection bottlenecks.
Lifecycle Tracking
Monitor the progression of mandates from initial authorization to the final scheduled installment fulfillment.
Why Use Installment Lookup?
Precision in recurring billing requires absolute clarity on payment cycles. Use the Get Installment API to verify upcoming debit schedules, track historical successes, and synchronize your internal ledger with real-time mandate data.
Query Mandate Cycles in Real-Time
Retrieve specific installment breakdowns for any registered mandate. Access critical data points like paid counts, next scheduled debits, and remaining cycle amounts instantly.
curl --request GET \
--url https://api.idspay.in/v3/mandate/installments \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"mandate_id": "MND_7788990022"
}'{
"status": "SUCCESS",
"data": {
"mandate_id": "MND_7788990022",
"total_cycles": "24",
"processed_installments": "5",
"upcoming_debit_date": "2026-06-15",
"amount_per_cycle": "2499.00",
"currency": "INR"
}
}🔍 Precision of Installment API
Equip your billing system with absolute intelligence. Validate mandate installment counts, verify recurring amounts, and track collection schedules with 100% accuracy.
Cycle Scheduling
Retrieve exact debit dates from the payment roadmap to ensure seamless recurring collection alignment.
Count Monitoring
Track successful installments processed against the total authorized cycles within any specific mandate.
Amount Audit
Verify exact cycle amounts to prevent billing discrepancies and ensure compliance with mandate limits.
Due Date Sync
Sync next-due-date data into your notification engine to improve collection success rates via reminders.
Collection Logs
Analyze historical payment patterns to identify customer trends and optimize future collection strategies.
Balance Tracking
Instantly view outstanding balances and total collected funds for real-time financial reconciliation.
Sequence Status
Identify the current active installment in the series to manage service access and subscription logic.
Yield Forecasts
Leverage structured installment data to forecast long-term revenue and measure mandate profitability.
How Installment API Works
Effortlessly map the entire lifecycle of a mandate's payment schedule with our high-speed automated retrieval process.
1. Request Initiation
Send a GET request containing the unique Mandate ID to authorize the installment schedule lookup.
2. Timeline Retrieval
The API scans the mandate's registry to aggregate all past collection attempts and upcoming debit dates.
3. Cycle Verification
Our system calculates the current sequence position and cross-references it with mandate frequency rules.
4. Response Delivery
Receive a structured JSON payload detailing installment status, dates, and amounts for immediate billing action.
Master Your Billing Cycles with Get Installment API
The Get Installment By Mandate API serves as your centralized tracking hub, delivering real-time status updates for every payment cycle within a mandate.
Eliminate guesswork by accessing automated schedule retrieval. Our endpoint provides the transparency needed to monitor successful debits, identify pending installments, and anticipate future collection windows.
From reconciling complex ledgers to managing automated renewals, this Reporting Tool empowers your platform with the granular data required for seamless, subscription-based financial operations.
Why IDSPay is Better than Other Installment APIs?
See how our cycle tracking outperforms industry standards.
Instant Cycle Updates
Retrieve current installment counts with lower latency than traditional status APIs.
Superior Accuracy
More precise ledger reconciliation than Eko & API Mall for subscription tracking.
Developer-First Docs
Simplified installment logic mapping compared to the complex structures of Digitap.
Scalable Pricing
Low-cost per-query pricing designed to support high-volume recurring billing startups.
Integration Support
Direct access to fintech engineers to help you map complex installment schedules 24/7.
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 the Get Installment By Mandate API and payment cycle tracking.
What is the Get Installment By Mandate API?
The Get Installment By Mandate API is a specialized endpoint that provides a detailed breakdown of a mandate's payment schedule. It retrieves the status of past installments, specific due dates for future cycles, and the total collection progress.
2. When should I use the Installment API?
Use this API when you need to confirm which installment number is currently due, reconcile successful versus failed payments in a series, or provide a customer with their upcoming billing roadmap.
3. Does it show the status of individual payments?
Yes. The API returns an array of installment objects, each indicating whether that specific cycle was 'Settled', 'Failed', or is still 'Upcoming' in the schedule.
4. Can I see the remaining collection limit?
Yes, the response provides total authorized amount versus the amount already collected, helping you calculate the remaining headroom for future installments.
5. What if an installment was partially paid?
The API tracks the exact amount collected per cycle. If your business logic allows variable amounts, the response will reflect the specific value debited for that particular installment number.
6. How does the API handle ad-hoc installments?
For 'As and When Presented' mandates, the API provides a chronological log of every debit presentation attempt, allowing you to track frequency and total volume without a fixed calendar schedule.
7. Can I identify the next collection date?
Yes. The API explicitly flags the 'next_due_date' based on the registered frequency, enabling you to trigger automated pre-debit SMS or Email notifications to your users.
8. Does it provide UMRN-level transaction mapping?
Yes. Every installment entry is mapped back to the mandate's UMRN, ensuring that your financial audits and bank-side reconciliations remain perfectly synchronized.
9. How are failed installments displayed?
Failed installments are returned with a specific failure reason and the original attempt timestamp, allowing your system to decide whether to re-attempt the debit or skip to the next cycle.
10. Is the installment data updated in real-time?
Yes. As soon as a transaction response is processed by our gateway, the installment ledger is updated. You can query this API to get the most current view of your recurring revenue pipeline.