Full train route

Get stops and pass-through stations.

GET /v1/trains/{train_number}/route

Scope schedule:read · Cost 1 request · Plans All plans

Returns the complete route, including points where the train does not stop. A passing point (stop_type PASSING) has its booked times, distance and coordinates; it has no platform or typical delay, so those fields are left out there. Train-level fields (classes, catering, pantry, rake type) and each halt's platform and typical delays are the same as on the schedule.

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 schedule: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
train_numberpathstringRequiredTrain number, 4 to 6 uppercase letters or digits.

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/trains/12656/route"

JavaScript

const response = await fetch("https://ir.railcore.tech/v1/trains/12656/route", {
  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/trains/12656/route",
    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
train_numberstringCanonical train number.
train_namestringCanonical train name.
source_station_codestringOrigin station code.
destination_station_codestringFinal destination station code.
running_daysRunningDay[]MON through SUN values on which the train runs.
classesClassCode[]Classes the train carries, highest first, from RailCore's train catalog: 1A, 2A, 3A, 3E, EC, CC, FC, SL, 2S, and GS for unreserved general. Empty only for a train the catalog has no classes for.
total_duration_minutesintegerEnd-to-end scheduled duration.
distance_kmnumberEnd-to-end distance.
catering / pantrybooleanWhether food can be ordered on the train, and whether it carries a pantry car. Left out until RailCore has read the train's extras: the next request has them.
rake_typestringCoach build, such as LHB or ICF. Left out until RailCore has read the train's extras.
valid_from / valid_tostring(date)First and last day this timetable applies. Each is present only when the railway dated it; most timetables have no end date, so valid_to is usually left out.
stops[].sequenceintegerPosition in the route, starting at 1.
stops[].station_codestringStop station code.
stops[].station_namestringStop station name, written as the RailCore site writes it (New Delhi, Mumbai Central), not the upper-case booking name.
stops[].stop_typestringWhat the station is to the train. ORIGIN is where it starts and DESTINATION where it ends; HALT is a station it stops at; PASSING is one it runs through without stopping.
stops[].notesobjectAt the first and last stations only, in place of the time the train does not have there: notes.arrival at the ORIGIN (Starts at Mumbai Central: departs only, no arrival), notes.departure at the DESTINATION (Ends at New Delhi: arrives only, no departure). Left out at every other stop.
stops[].arrival_timestringScheduled arrival in HH:mm. Left out at the ORIGIN: a train does not arrive where it starts. notes.arrival says so.
stops[].departure_timestringScheduled departure in HH:mm. Left out at the DESTINATION: a train does not leave where it ends. notes.departure says so.
stops[].halt_minutesintegerScheduled halt duration. 0 at the origin, the destination and a passing station.
stops[].dayintegerJourney day number.
stops[].distance_kmnumberDistance from the origin in km. At a halt, the railway timetable's whole kilometres; at a passing station, worked out to 0.1 km.
stops[].platform_numberstringPlatform the train is booked on. Left out where the timetable names none, and at a station it passes without stopping.
stops[].latitude / longitudenumberStation coordinates.
stops[].typical_arrival_delay_minutes / typical_departure_delay_minutesintegerTypical delay at this stop in minutes, from a fixed delay profile: the same on every date and every request, never a live reading. Left out when there is no profile for the stop, and at a station the train passes without stopping. For how late a run is now, call live train status.
stops[].arrival_delay_minutes / departure_delay_minutes (deprecated)integerDeprecated aliases of typical_arrival_delay_minutes and typical_departure_delay_minutes, with the same values, and left out with them. They are not live delay. Removed no earlier than December 7, 2026, 30 days after the November 7, 2026 notice.
stops[].is_stopbooleanFalse for pass-through route points.

Example response

{
  "success": true,
  "data": {
    "train_number": "12656",
    "train_name": "Navjeevan SF Express",
    "classes": [
      "1A",
      "2A",
      "3A",
      "3E",
      "SL",
      "GS"
    ],
    "catering": true,
    "pantry": true,
    "rake_type": "LHB",
    "stops": [
      {
        "sequence": 1,
        "station_code": "MAS",
        "station_name": "MGR Chennai Central",
        "stop_type": "ORIGIN",
        "notes": {
          "arrival": "Starts at MGR Chennai Central: departs only, no arrival"
        },
        "departure_time": "10:10",
        "halt_minutes": 0,
        "day": 1,
        "distance_km": 0,
        "platform_number": "6",
        "is_stop": true
      },
      {
        "sequence": 2,
        "station_code": "BBQ",
        "station_name": "Basin Bridge Junction",
        "stop_type": "PASSING",
        "arrival_time": "10:11",
        "departure_time": "10:11",
        "halt_minutes": 0,
        "day": 1,
        "distance_km": 2.1,
        "latitude": 13.102361,
        "longitude": 80.271221,
        "is_stop": false
      }
    ]
  },
  "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
404TRAIN_NOT_FOUNDNo train has that number. error.message names it: Train 99999 not found. Check the train number. 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

Related Trains endpoints

All RailCore Indian Railways API endpoints · Quickstart · Rate limits

Last updated