Check up to 25 train and class combinations.
POST /v1/availability/seats/batch
Scope availability:read · Cost 1 request per distinct class per item, minimum 1 request · Plans All plans
Returns independent availability results for every item. Each distinct class asked for on each item counts as one request. Classes are compared without regard to case or surrounding spaces, so "SL", "sl" and "SL" again in one item count once.
Send your key in one header: X-RailCore-Key, Authorization: Bearer or X-Api-Key. Two headers with different keys answer 401 AMBIGUOUS_API_KEY. This operation requires the availability:read scope. Growth, Scale and Enterprise keys must also sign every request with HMAC-SHA256, sending X-RailCore-Timestamp, X-RailCore-Nonce and X-RailCore-Signature. Free and Starter keys send the key alone. See the authentication guide and HMAC signing.
This operation takes no path or query parameters.
| Field | Type | Description |
|---|---|---|
items | AvailabilityInput[] | Array with 1 to 25 items. |
items[].train_number | string | Train number. |
items[].from | string | Boarding station code. |
items[].to | string | Destination station code. |
items[].date | string(date) | Journey date. |
items[].classes | ClassCode[] | Up to 8 classes; a class repeated in one item is checked and counted once. Left out or empty, the train's own bookable classes are checked and counted (for a train RailCore does not list, 4 default classes). |
items[].quota | Quota | Optional reservation quota. Seat availability answers GN (General), TQ (Tatkal), SS (Lower berth / senior citizen) and LD (Ladies). Any other quota, Premium Tatkal (PT) included, is refused for every train with 422 QUOTA_NOT_SUPPORTED before the seat provider is asked, and is not counted. |
Base URL https://ir.railcore.tech/v1. Keep the key in an environment variable and call from a trusted server-side environment.
JOURNEY_DATE=$(date -u -d "+7 days" +%F 2>/dev/null || date -u -v+7d +%F)
JOURNEY_DATE_2=$(date -u -d "+8 days" +%F 2>/dev/null || date -u -v+8d +%F)
curl -sS -X POST \
-H "X-RailCore-Key: $RAILCORE_KEY" \
-H "Content-Type: application/json" \
--data '{"items":[{"train_number":"12656","from":"BSL","to":"ADI","date":"'"$JOURNEY_DATE"'","classes":["SL","3A"],"quota":"GN"},{"train_number":"12952","from":"NDLS","to":"BCT","date":"'"$JOURNEY_DATE_2"'","classes":["2A"],"quota":"GN"}]}' \
"https://ir.railcore.tech/v1/availability/seats/batch"
const journeyDate = new Date(Date.now() + 7 * 86_400_000).toISOString().slice(0, 10);
const journeyDate2 = new Date(Date.now() + 8 * 86_400_000).toISOString().slice(0, 10);
const response = await fetch("https://ir.railcore.tech/v1/availability/seats/batch", {
method: "POST",
headers: {
"X-RailCore-Key": process.env.RAILCORE_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"items": [
{
"train_number": "12656",
"from": "BSL",
"to": "ADI",
"date": journeyDate,
"classes": [
"SL",
"3A"
],
"quota": "GN"
},
{
"train_number": "12952",
"from": "NDLS",
"to": "BCT",
"date": journeyDate2,
"classes": [
"2A"
],
"quota": "GN"
}
]
}),
});
const body = await response.json();
console.log(response.status, body);
import datetime
import os
import requests
journey_date = (datetime.date.today() + datetime.timedelta(days=7)).isoformat()
journey_date_2 = (datetime.date.today() + datetime.timedelta(days=8)).isoformat()
response = requests.request(
"POST",
"https://ir.railcore.tech/v1/availability/seats/batch",
headers={"X-RailCore-Key": os.environ["RAILCORE_KEY"]},
json={"items": [{"train_number": "12656", "from": "BSL", "to": "ADI", "date": journey_date, "classes": ["SL", "3A"], "quota": "GN"}, {"train_number": "12952", "from": "NDLS", "to": "BCT", "date": journey_date_2, "classes": ["2A"], "quota": "GN"}]},
timeout=20,
)
print(response.status_code, response.json())
This operation counts as 1 request per distinct class per item, minimum 1 request and is available on all plans. Failed requests are free. Per-minute budgets, daily caps and the headers reporting what is left are in rate limits; plans and prices are in requests and billing.
| Field | Type | Description |
|---|---|---|
results[] | AvailabilityResponse[] | Per-input availability result. |
results[].train_number | string | Train number. |
results[].from_station_code / to_station_code | string | Requested segment. |
results[].journey_date | string(date) | Requested journey date. |
results[].quota | Quota | Applied quota. |
results[].classes[].class_code | ClassCode | Travel class. |
results[].classes[].status | string | AVAILABLE, RAC, WAITLIST, REGRET, NOT_AVAILABLE, TRAIN_CANCELLED, TRAIN_DEPARTED, or UNKNOWN. |
results[].classes[].availability_text | string | Source availability text normalized for display. |
results[].classes[].available_count | integer | null | Available berth count; null when the source reports availability without a quantity. |
results[].classes[].waitlist_count / rac_count | integer | null | Current waitlist and RAC positions; null when the active status has no reported position. |
results[].classes[].wl_pool / wl_pool_position | string / integer | Original booking pool and position, read from the availability text (GNWL276/WL185 gives GNWL and 276). Present only when the text names the pool; left out otherwise. They can stay after the current status becomes RAC or available. Compatibility codes are preserved exactly, without inferred quota descriptions. |
results[].classes[].fare / total_fare | integer | null | Fare values in INR. total_fare is what the ticket costs; fare is total_fare less catering_charge. |
results[].classes[].catering_charge | integer | Catering included in total_fare, in INR. 0 on a train without compulsory catering. |
results[].classes[].fare_breakdown | object | absent | The railway's split of total_fare in INR: base_fare, reservation_charge, superfast_charge, tatkal_charge, dynamic_fare, fuel_charge, other_charge, gst, catering_charge, rounding (what the railway added to reach the next ₹5, 0 to 4) and concession (subtracted). The parts always add up to total_fare; a null part was not given. Absent when the enquiry gave no split. |
results[].classes[].confirmation_probability | object | null | The chance that a ticket booked now is confirmed: percentage, a LOW/MEDIUM/HIGH label and text. 100 (Available) when seats are available; 0 with the reason in text when no ticket can be booked (Waitlist full (regret) for a REGRET class, whose waitlist is full and can reopen as tickets are cancelled; not available; train departed or cancelled); the forecast for a waitlisted or RAC ticket. Null only for a waitlisted or RAC class with no forecast. |
results[].classes[].last_updated_at | string | null | When the figure was read at the source. It can be hours before your request when the upstream answers from its own cache, so use it to evaluate freshness. |
{
"success": true,
"data": {
"results": [
{
"train_number": "12656",
"from_station_code": "BSL",
"to_station_code": "ADI",
"journey_date": "2026-11-27",
"quota": "GN",
"classes": [
{
"class_code": "3A",
"status": "AVAILABLE",
"availability_text": "AVAILABLE-4",
"available_count": 4,
"waitlist_count": 0,
"rac_count": 0,
"fare": 965,
"catering_charge": 0,
"total_fare": 965,
"fare_breakdown": {
"base_fare": 834,
"reservation_charge": 40,
"superfast_charge": 45,
"tatkal_charge": 0,
"dynamic_fare": 0,
"fuel_charge": 0,
"other_charge": 0,
"gst": 46,
"catering_charge": 0,
"concession": 0,
"rounding": 0
},
"confirmation_probability": {
"percentage": 100,
"label": "HIGH",
"text": "Available"
},
"last_updated_at": "2026-11-20T08:15:46.547+05:30"
}
]
}
]
},
"meta": {
"api_version": "v1",
"request_id": "req_01J5Z7Y8N2K4M6P8R0T2V4X6Z8",
"trace_id": "trc_01J5Z7Y8N2K4M6P8R0T2V4X6Z9",
"timestamp": "2026-11-20T10:57:05.609Z",
"freshness": {
"mode": "live",
"retrieved_at": "2026-11-20T10:57:05.609Z",
"sources": [
{
"confidence": "high"
}
]
}
}
}
| Status | Code | Description | Retry |
|---|---|---|---|
| 422 | QUOTA_NOT_SUPPORTED | No item names a quota seat availability answers (GN, TQ, SS, LD). Such an item among others comes back in its place as a failed item with error QUOTA_NOT_SUPPORTED instead, and is not counted. | Not retryable |
| 422 | BOOKING_NOT_OPEN | Every item's date is past the booking window: reservations open 60 days before the journey, at 8:00 AM in India. An item past the window among others comes back as a failed item instead. Not counted. | Not retryable |
| 400 | VALIDATION_ERROR | A required field is missing or invalid. error.details[].field names the parameter, such as date or items[2].date. | Not retryable |
| 401 | MISSING_API_KEY | No key in X-RailCore-Key, Authorization: Bearer or X-Api-Key, or the key is too short. | Not retryable |
| 401 | INVALID_API_KEY | The key is unknown or revoked. A disabled or expired key answers API_KEY_DISABLED or API_KEY_EXPIRED. | Not retryable |
| 401 | AMBIGUOUS_API_KEY | More than one key header was sent, with different keys. Send the key in one header. | Not retryable |
| 401 | SIGNATURE_INVALID | HMAC signature missing or not verified. Growth, Scale and Enterprise keys must sign every request; a key with no signing secret must be rotated. | Not retryable |
| 403 | SCOPE_MISSING | The key lacks this operation's scope. | Not retryable |
| 403 | PLAN_ENDPOINT_DISABLED | The account's plan does not include this endpoint. | Not retryable |
| 402 | CREDITS_EXHAUSTED | The month's requests are used up, or too few are left for this request. Nothing is fetched. | Not retryable |
| 429 | RATE_LIMITED | The account's per-minute budget, or a Free account's daily budget, is used up. Every key on the account shares it. Honor Retry-After. | Retryable |
| 410 | API_VERSION_SUNSET | This API version has reached its announced sunset date. Migrate to a supported major version. | Not retryable |
| 503 | UPSTREAM_UNAVAILABLE | Live data could not be retrieved. Wait for Retry-After, then retry with backoff. Not counted. | Retryable |
| 503 | UPSTREAM_TIMEOUT | The live-data request ran past its deadline. Wait for Retry-After, then retry with backoff. Not counted. | Retryable |
| 503 | METERING_UNAVAILABLE | The request could not be counted, so no data was returned. Retry with backoff. | Retryable |
All RailCore Indian Railways API endpoints · Quickstart · Rate limits
Last updated