Live station board

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.

Authentication

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.

Request parameters

NameInTypeRequiredDescription
station_codepathstringRequiredIndian Railways station code, 1 to 6 uppercase letters or digits.
window_hoursqueryintegerOptionalHow 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.

Code examples

Base URL https://ir.railcore.tech/v1. Keep the key in an environment variable and call from a trusted server-side environment.

cURL

curl -sS -X GET \
  -H "X-RailCore-Key: $RAILCORE_KEY" \
  "https://ir.railcore.tech/v1/stations/NDLS/live?window_hours=8"

JavaScript

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);

Python

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())

Rate limits and cost

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.

Response fields

FieldTypeDescription
station_codestringBoard station.
window_hoursintegerHow 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.tostring(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_aheadintegerHow far back (always 2) and how far ahead (window_hours) the board looks.
trains[].train_number / train_namestringTrain 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_namestringThe 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_codestringThe 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_namestringThe train's first and last stations, named in full: Chhatrapati Shivaji Maharaj Terminus, not the booking name C SHIVAJI MAH T.
trains[].train_typestringCanonical train category.
trains[].scheduled_arrival / scheduled_departurestring(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_departurestring(date-time)Latest expected times. Before the live feed forecasts the train, the booked times, with timing_basis scheduled.
trains[].timing_basisstringlive: 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_basisstringplatform_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_minutesintegerHow 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_numberstringReported platform. Left out until one is announced; notes.platform says so.
trains[].arrival_delay_minutes / departure_delay_minutesintegerMinutes 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_minutesintegerBooked and observed halt duration. actual_halt_minutes is left out until observed; notes.halt says why.
trains[].start_datestring(date)Origin departure date identifying this train run.
trains[].statusstringNOT_STARTED, ON_ROUTE, AT_STATION, ARRIVED, DEPARTED, SEVERELY_DELAYED, CANCELLED, DIVERTED, or UNKNOWN.
trains[].confidence / last_reported_atstringFreshness 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_stationstring / booleanWhere 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[].notesobjectIn 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_typestringORIGIN, INTERMEDIATE, or DESTINATION at the requested station.
trains[].cancellationobjectAlways 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).

Example response

{
  "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"
        }
      ]
    }
  }
}

Errors

StatusCodeDescriptionRetry
404STATION_NOT_FOUNDNo station has that code. error.message names it: Station ZZZZ not found. Check the station code. Not counted.Not retryable
400VALIDATION_ERRORA required field is missing or invalid. error.details[].field names the parameter, such as date or items[2].date.Not retryable
401MISSING_API_KEYNo key in X-RailCore-Key, Authorization: Bearer or X-Api-Key, or the key is too short.Not retryable
401INVALID_API_KEYThe key is unknown or revoked. A disabled or expired key answers API_KEY_DISABLED or API_KEY_EXPIRED.Not retryable
401AMBIGUOUS_API_KEYMore than one key header was sent, with different keys. Send the key in one header.Not retryable
401SIGNATURE_INVALIDHMAC 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
403SCOPE_MISSINGThe key lacks this operation's scope.Not retryable
403PLAN_ENDPOINT_DISABLEDThe account's plan does not include this endpoint.Not retryable
402CREDITS_EXHAUSTEDThe month's requests are used up, or too few are left for this request. Nothing is fetched.Not retryable
429RATE_LIMITEDThe 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
410API_VERSION_SUNSETThis API version has reached its announced sunset date. Migrate to a supported major version.Not retryable
503UPSTREAM_UNAVAILABLELive data could not be retrieved. Wait for Retry-After, then retry with backoff. Not counted.Retryable
503UPSTREAM_TIMEOUTThe live-data request ran past its deadline. Wait for Retry-After, then retry with backoff. Not counted.Retryable
503METERING_UNAVAILABLEThe request could not be counted, so no data was returned. Retry with backoff.Retryable

Implementation notes

Related Stations endpoints

All RailCore Indian Railways API endpoints · Quickstart · Rate limits

Last updated