Core concepts
Plans, per-request costs, and batches.
X-RailCore-Credits-Cost is what this request counted as and X-RailCore-Credits-Remaining the requests left. One credit is one request.CREDITS_EXHAUSTED until the plan renews or you change plan.Monthly list prices in Indian rupees. Rate limits are on the rate limits page.
| Plan | List price | Requests a month | Per 1,000 requests | Use |
|---|---|---|---|---|
| Free | ₹0 | 500 | Free | Evaluation and personal projects |
| Starter | ₹699/month | 40,000 | ₹17.48 | Commercial use |
| Growth | ₹2,499/month | 1,50,000 | ₹16.66 | Commercial use |
| Scale | ₹6,499/month | 5,00,000 | ₹13.00 | Commercial use |
| Enterprise | Contract | Agreed volume | Contract | Commercial use |
Most endpoints count each request as one. The chart suite counts more because each of its requests does far more work.
| Operation | Requests | Plans |
|---|---|---|
GET/v1/stations/search | 1 request | All plans |
GET/v1/stations/{station_code} | 1 request | All plans |
GET/v1/stations/{station_code}/live | 1 request | All plans |
GET/v1/trains/search | 1 request | All plans |
GET/v1/trains/{train_number} | 1 request | All plans |
GET/v1/trains/{train_number}/schedule | 1 request | All plans |
GET/v1/trains/{train_number}/stops | 1 request | All plans |
GET/v1/trains/{train_number}/route | 1 request | All plans |
GET/v1/trains/{train_number}/coach-position | 1 request | All plans |
GET/v1/trains/{train_number}/live | 1 request | All plans |
GET/v1/routes/trains | 1 request | All plans |
GET/v1/journeys/search | 1 request | All plans |
POST/v1/journeys/compare | 1 request per route compared, minimum 1 request | All plans |
GET/v1/availability/seats | 1 request | All plans |
POST/v1/availability/seats/batch | 1 request per distinct class per item, minimum 1 request | All plans |
GET/v1/availability/calendar | 1 request | All plans |
GET/v1/availability/classes | 1 request | All plans |
GET/v1/fares/estimate | 1 request | All plans |
GET/v1/fares/search | 1 request | All plans |
GET/v1/fares/unreserved | 1 request | All plans |
GET/v1/charts/status | 1 request | Scale and Enterprise |
GET/v1/charts/vacant-berths | 3 requests | Scale and Enterprise |
GET/v1/charts/vacant-berths/hopping | 4 requests | Scale and Enterprise |
GET/v1/charts/vacant-berths/route-scan | 8 requests | Scale and Enterprise |
POST/v1/jobs/route-scan | 8 requests | Scale and Enterprise |
POST/v1/jobs/hopping | 4 requests | Scale and Enterprise |
GET/v1/jobs/{job_id} | 0 requests | Scale and Enterprise |
DELETE/v1/jobs/{job_id} | 0 requests | Scale and Enterprise |
GET/v1/jobs/{job_id}/stream | 0 requests | Scale and Enterprise |
GET/v1/jobs | 0 requests | Scale and Enterprise |
// POST /v1/availability/seats/batch
// 1 request per distinct class per item, minimum 1 request. Classes compare case-insensitively,
// so a class repeated in one item counts once. An item without classes,
// or with an empty list, is checked in 4 default classes.
const distinctClasses = (classes) => new Set(classes.map((code) => String(code).trim().toUpperCase())).size;
const classRequests = items.reduce((total, item) => total + (item.classes?.length ? distinctClasses(item.classes) : 4), 0);
const batchCalls = Math.max(1, classRequests);
// POST /v1/journeys/compare
// 1 request per route compared, minimum 1 request.
const compareCalls = Math.max(1, journeys.length);The largest batch, 25 items with 8 classes each, counts as 200 requests. Comparing 5 routes counts as 5 requests.
The cost is worked out from the request body before any lookup runs. A batch or comparison that answers 200 is counted at that size: an item or route that fails inside the response still counts, and nothing is given back for it. A request refused as a whole (4xx or 5xx) is free. Ask only for the classes you need.
2xxCounted. X-RailCore-Credits-Cost and X-RailCore-Credits-Remaining report the requests counted and left.
4xx or 5xxNot counted.
402Too few requests are left to cover this one. Nothing is fetched.
503 METERING_UNAVAILABLEA successful live result is withheld because the request could not be counted.
Async jobsSubmission is counted when accepted, and stays counted if the job later fails or is cancelled. Polling, listing, streaming and cancelling count as 0 requests.
Last updated