Inspect availability across upcoming dates.
GET /v1/availability/calendar
Scope availability:read · Cost 1 request · Plans All plans
Finds the dates the train runs in a window of up to 30 days, then makes one seat enquiry per running date, four at a time. Returns class-level availability, fare, probability, and when each date's figure was read. Dates the train does not run on are left out.
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.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
train_number | query | string | Required | Train number, 4 to 6 uppercase letters or digits. |
from | query | string | Required | Boarding station code. |
to | query | string | Required | Destination station code. |
class | query | string | Required | Travel class code. |
quota | query | string | 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. |
date | query | string(date) | Optional | First date of the window, today or later. Defaults to today in India. |
days | query | integer | Optional | Number of calendar days. |
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)
curl -sS -X GET \
-H "X-RailCore-Key: $RAILCORE_KEY" \
"https://ir.railcore.tech/v1/availability/calendar?train_number=12656&from=BSL&to=ADI&class=3A"a=GN&date=$JOURNEY_DATE&days=7"
const journeyDate = new Date(Date.now() + 7 * 86_400_000).toISOString().slice(0, 10);
const response = await fetch(`https://ir.railcore.tech/v1/availability/calendar?train_number=12656&from=BSL&to=ADI&class=3A"a=GN&date=${journeyDate}&days=7`, {
method: "GET",
headers: {
"X-RailCore-Key": process.env.RAILCORE_KEY,
},
});
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()
response = requests.request(
"GET",
f"https://ir.railcore.tech/v1/availability/calendar?train_number=12656&from=BSL&to=ADI&class=3A"a=GN&date={journey_date}&days=7",
headers={"X-RailCore-Key": os.environ["RAILCORE_KEY"]},
timeout=20,
)
print(response.status_code, response.json())
This operation counts as 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 |
|---|---|---|
train_number / from_station_code / to_station_code | string | Requested train and segment. |
class_code / quota | string | Applied class and quota. |
days[].date / day_of_week | string | Calendar date and running day. |
days[].status / availability_text | string | Normalized availability. |
days[].available_count | integer | null | Available berth count; null when the source supplies no quantity. |
days[].waitlist_count | integer | null | Current waitlist position; null when not supplied for the active waitlist status. |
days[].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 a pool. |
days[].fare | integer | null | Fare in INR without compulsory catering. Null when the day's own enquiry failed. |
days[].catering_charge / total_fare | integer | Catering included in the ticket, and what the ticket costs: fare plus catering_charge. Present when the day was read from its own enquiry. |
days[].confirmation_probability | object | null | The chance that a ticket booked now is confirmed: 100 when seats are available, 0 with the reason in text when no ticket can be booked (Waitlist full (regret) on a REGRET day), the forecast for a waitlisted or RAC day. Null only for a waitlisted or RAC day with no forecast. |
days[].last_updated_at | string | null | When that date's figure was read at the source; null when its own enquiry failed and the figure came from the provider's listing. |
{
"success": true,
"data": {
"train_number": "12656",
"from_station_code": "BSL",
"to_station_code": "ADI",
"class_code": "3A",
"quota": "GN",
"days": [
{
"date": "2026-11-27",
"day_of_week": "FRI",
"status": "AVAILABLE",
"availability_text": "AVAILABLE-4",
"available_count": 4,
"waitlist_count": 0,
"fare": 965,
"confirmation_probability": {
"percentage": 100,
"label": "HIGH",
"text": "Available"
},
"last_updated_at": "2026-11-20T10:55:33.825+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 | Seat availability is not offered for that quota on any train: it answers GN, TQ, SS and LD only. Premium Tatkal (PT), HP, DP, HO, YU and FT can be checked on IRCTC. RailCore refuses it before the seat provider is asked. Not counted. | Not retryable |
| 422 | BOOKING_NOT_OPEN | The date has not opened for booking: reservations open 60 days before the journey, at 8:00 AM in India. RailCore refuses it before the seat provider is asked. error.message names the day it opens. Not counted. | Not retryable |
| 404 | TRAIN_NOT_FOUND | No train has that number. error.message names it: Train 99999 not found. Check the train number. 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