Arrivals and departures from 2 hours ago to 4 or 8 hours ahead.
GET /v1/stations/{station_code}/live
Scope live:read · Cost 1 request · Plans All plans
Returns one canonical station board for trains arriving at, departing from, starting at, or terminating at the station, with schedule, estimate, platform, delay, state, confidence, and report time. A train is listed when its expected or booked time at the station, arriving or leaving, falls inside the window: from 2 hours ago to window_hours ahead.
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 live: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 |
|---|---|---|---|---|
station_code | path | string | Required | Indian Railways station code, 1 to 6 uppercase letters or digits. |
window_hours | query | integer | Optional | How far ahead the board looks. It lists trains due at the station from 2 hours ago until this many hours later, by expected or booked time. 4 or 8; any other value is read as 8. |
Base URL https://ir.railcore.tech/v1. Keep the key in an environment variable and call from a trusted server-side environment.
curl -sS -X GET \
-H "X-RailCore-Key: $RAILCORE_KEY" \
"https://ir.railcore.tech/v1/stations/NDLS/live?window_hours=8"
const response = await fetch("https://ir.railcore.tech/v1/stations/NDLS/live?window_hours=8", {
method: "GET",
headers: {
"X-RailCore-Key": process.env.RAILCORE_KEY,
},
});
const body = await response.json();
console.log(response.status, body);
import os
import requests
response = requests.request(
"GET",
"https://ir.railcore.tech/v1/stations/NDLS/live?window_hours=8",
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 |
|---|---|---|
station_code | string | Board station. |
window_hours | integer | How far ahead the board looks, in hours from now: 4 or 8. Check it when you send anything other than 4 or 8. |
window.from / window.to | string(date-time) | The bounds the board was cut to, as India-time instants with their +05:30 offset: 2 hours before the request and window_hours after it. |
window.hours_back / window.hours_ahead | integer | How far back (always 2) and how far ahead (window_hours) the board looks. |
trains[].train_number / train_name | string | Train number, and the name the live feed gives, often abbreviated (GKP DR EXP). When the feed named other first or last stations than RailCore's train catalog has for that number, the feed's row was for another train with the same number, and train_name is the catalog's name. |
trains[].extended_train_name | string | The train's full name from RailCore's train catalog (Dadar Central Express). The same as train_name for a train the catalog does not list. |
trains[].source_station_code / destination_station_code | string | The train's first and last stations, from RailCore's train catalog when it lists the train: the catalog wins over the live feed, which reuses numbers for other local trains. A train the catalog does not list keeps the feed's. |
trains[].source_station_name / destination_station_name | string | The train's first and last stations, named in full: Chhatrapati Shivaji Maharaj Terminus, not the booking name C SHIVAJI MAH T. |
trains[].train_type | string | Canonical train category. |
trains[].scheduled_arrival / scheduled_departure | string(date-time) | Booked times at the station, India time with +05:30. A departure that crosses midnight is dated the next day. The origin has no arrival and the destination no departure; notes.arrival and notes.departure say so. |
trains[].estimated_arrival / estimated_departure | string(date-time) | Latest expected times. Before the live feed forecasts the train, the booked times, with timing_basis scheduled. |
trains[].timing_basis | string | live: the expected times come from the live feed. scheduled: no forecast yet, so they are the booked times, with a delay of 0. |
trains[].platform_basis | string | platform_basis says where the platform comes from: announced (the live station board names it), expected (not on the board yet; the railway's running status of this run names it) or usual (neither does; the train's usual platform from the timetable, not confirmed for today). They can differ: on 2026-11-12 64114's usual platform at NDLS was 11 and its expected one 10. |
trains[].rescheduled_minutes | integer | How far the railway moved a train that has not started, in minutes, 15 or more: the gap between its booked and expected times that its delay does not explain. Its delay counts from the new time. Left out for a train that was not moved. |
trains[].platform_number | string | Reported platform. Left out until one is announced; notes.platform says so. |
trains[].arrival_delay_minutes / departure_delay_minutes | integer | Minutes late. 0 when the expected time is the booked one (timing_basis scheduled). For a rescheduled train, counted from the new time. |
trains[].scheduled_halt_minutes / actual_halt_minutes | integer | Booked and observed halt duration. actual_halt_minutes is left out until observed; notes.halt says why. |
trains[].start_date | string(date) | Origin departure date identifying this train run. |
trains[].status | string | NOT_STARTED, ON_ROUTE, AT_STATION, ARRIVED, DEPARTED, SEVERELY_DELAYED, CANCELLED, DIVERTED, or UNKNOWN. |
trains[].confidence / last_reported_at | string | Freshness confidence and source report time. last_reported_at is left out before the train has been reported; notes.last_reported says so. |
trains[].current_station_code / departed_current_station | string / boolean | Where the train is and whether it has left there. A train that has not started is at its first station, with departed_current_station false. Left out only when a running train's position is not reported. |
trains[].notes | object | In place of a field that has no value, why not. A time field only ever holds a real time; when one is missing, the note for its group says why. Present only with at least one note. Keys: arrival (Starts at New Delhi: departs only, no arrival), departure (Ends at New Delhi: arrives only, no departure), halt (Starts at …: no halt, Ends at …: no halt, or Has not stopped here yet), platform (Platform not announced yet; or, with platform_basis expected or usual, where the platform came from), last_reported (Not reported yet, or Not reported yet: the train has not started), position (Not started yet: at its first station, <name>, or Position not reported yet), expected (No live forecast yet: the expected times are the booked ones) and rescheduled (Rescheduled by 6 h 20 min: now departs at 01:30 on 13 Nov). |
trains[].stop_type | string | ORIGIN, INTERMEDIATE, or DESTINATION at the requested station. |
trains[].cancellation | object | Always an object. cancellation.status is NOT_CANCELLED, PARTIALLY_CANCELLED or CANCELLED; fully_cancelled and message say the same, and from_station_code and to_station_code name the cancelled part of the route (left out when nothing is cancelled). |
{
"success": true,
"data": {
"station_code": "NDLS",
"window_hours": 8,
"window": {
"from": "2026-11-20T16:01:40+05:30",
"to": "2026-11-21T02:01:40+05:30",
"hours_back": 2,
"hours_ahead": 8
},
"trains": [
{
"train_number": "14004",
"train_name": "Malda Town Express",
"extended_train_name": "Malda Town Express",
"source_station_code": "NDLS",
"destination_station_code": "MLDT",
"source_station_name": "New Delhi",
"destination_station_name": "Malda Town",
"train_type": "MAIL_EXPRESS",
"scheduled_departure": "2026-11-20T18:00:00+05:30",
"estimated_departure": "2026-11-20T18:00:00+05:30",
"departure_delay_minutes": 0,
"timing_basis": "live",
"platform_number": "15",
"platform_basis": "announced",
"start_date": "2026-11-20",
"status": "NOT_STARTED",
"current_station_code": "NDLS",
"departed_current_station": false,
"stop_type": "ORIGIN",
"cancellation": {
"status": "NOT_CANCELLED",
"fully_cancelled": false,
"message": "No cancellation reported for this train"
},
"confidence": "high",
"last_reported_at": "2026-11-20T18:00:54+05:30",
"notes": {
"arrival": "Starts at New Delhi: departs only, no arrival",
"halt": "Starts at New Delhi: no halt"
}
},
{
"train_number": "64426",
"train_name": "New Delhi - Ghaziabad EMU",
"extended_train_name": "New Delhi - Ghaziabad EMU",
"source_station_code": "NDLS",
"destination_station_code": "GZB",
"source_station_name": "New Delhi",
"destination_station_name": "Ghaziabad",
"train_type": "SUBURBAN",
"scheduled_departure": "2026-11-20T18:15:00+05:30",
"estimated_departure": "2026-11-20T18:15:00+05:30",
"departure_delay_minutes": 0,
"timing_basis": "scheduled",
"platform_number": "6",
"platform_basis": "usual",
"start_date": "2026-11-20",
"status": "NOT_STARTED",
"current_station_code": "NDLS",
"departed_current_station": false,
"stop_type": "ORIGIN",
"cancellation": {
"status": "NOT_CANCELLED",
"fully_cancelled": false,
"message": "No cancellation reported for this train"
},
"confidence": "medium",
"notes": {
"arrival": "Starts at New Delhi: departs only, no arrival",
"halt": "Starts at New Delhi: no halt",
"expected": "No live forecast yet: the expected times are the booked ones",
"position": "Not started yet: at its first station, New Delhi",
"platform": "Usual platform from the timetable: not announced for today yet",
"last_reported": "Not reported yet: the train has not started"
}
},
{
"train_number": "22362",
"train_name": "Rajendra Nagar Terminal Amrit Bharat Express",
"extended_train_name": "Rajendra Nagar Terminal Amrit Bharat Express",
"source_station_code": "NDLS",
"destination_station_code": "RJPB",
"source_station_name": "New Delhi",
"destination_station_name": "Rajendra Nagar Terminal",
"train_type": "MAIL_EXPRESS",
"scheduled_departure": "2026-11-20T19:10:00+05:30",
"estimated_departure": "2026-11-21T01:30:00+05:30",
"departure_delay_minutes": 0,
"timing_basis": "live",
"rescheduled_minutes": 380,
"platform_number": "16",
"platform_basis": "announced",
"start_date": "2026-11-20",
"status": "NOT_STARTED",
"current_station_code": "NDLS",
"departed_current_station": false,
"stop_type": "ORIGIN",
"cancellation": {
"status": "NOT_CANCELLED",
"fully_cancelled": false,
"message": "No cancellation reported for this train"
},
"confidence": "medium",
"notes": {
"arrival": "Starts at New Delhi: departs only, no arrival",
"halt": "Starts at New Delhi: no halt",
"position": "Not started yet: at its first station, New Delhi",
"rescheduled": "Rescheduled by 6 h 20 min: now departs at 01:30 on 21 Nov",
"last_reported": "Not reported yet: the train has not started"
}
},
{
"train_number": "64433",
"train_name": "Ghaziabad - New Delhi EMU",
"extended_train_name": "Ghaziabad - New Delhi EMU",
"source_station_code": "GZB",
"destination_station_code": "NDLS",
"source_station_name": "Ghaziabad",
"destination_station_name": "New Delhi",
"train_type": "SUBURBAN",
"scheduled_arrival": "2026-11-20T17:40:00+05:30",
"estimated_arrival": "2026-11-20T17:56:00+05:30",
"arrival_delay_minutes": 16,
"timing_basis": "live",
"platform_number": "10",
"platform_basis": "announced",
"start_date": "2026-11-20",
"status": "ARRIVED",
"current_station_code": "NDLS",
"stop_type": "DESTINATION",
"cancellation": {
"status": "NOT_CANCELLED",
"fully_cancelled": false,
"message": "No cancellation reported for this train"
},
"confidence": "high",
"last_reported_at": "2026-11-20T17:56:27+05:30",
"notes": {
"departure": "Ends at New Delhi: arrives only, no departure",
"halt": "Ends at New Delhi: no halt"
}
}
]
},
"meta": {
"api_version": "v1",
"request_id": "req_01J5Z7Y8N2K4M6P8R0T2V4X6Z8",
"trace_id": "trc_01J5Z7Y8N2K4M6P8R0T2V4X6Z9",
"timestamp": "2026-11-20T10:57:05.605Z",
"freshness": {
"mode": "live",
"retrieved_at": "2026-11-20T10:57:05.605Z",
"sources": [
{
"confidence": "high"
}
]
}
}
}
| Status | Code | Description | Retry |
|---|---|---|---|
| 404 | STATION_NOT_FOUND | No station has that code. error.message names it: Station ZZZZ not found. Check the station code. 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