Trains between stations

Find trains serving a route on a date.

GET /v1/routes/trains

Scope journeys:read · Credits 5 · Plans All plans

Returns route-matching trains with schedule, classes, running pattern, and compact availability context.

Authentication

Send your key in the X-RailCore-Key header. This operation requires the journeys:read scope. See the authentication guide.

Request parameters

NameInTypeRequiredDescription
fromquerystringRequiredBoarding station code.
toquerystringRequiredDestination station code.
datequerystring(date)RequiredJourney date in YYYY-MM-DD format.
quotaquerystringOptionalReservation quota.

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/routes/trains?from=BSL&to=ADI&date=2026-08-27&quota=GN"

JavaScript

const response = await fetch("https://ir.railcore.tech/v1/routes/trains?from=BSL&to=ADI&date=2026-08-27&quota=GN", {
  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/routes/trains?from=BSL&to=ADI&date=2026-08-27&quota=GN",
    headers={"X-RailCore-Key": os.environ["RAILCORE_KEY"]},
    timeout=20,
)
print(response.status_code, response.json())

Rate limits and credits

This call costs 5 credits and is available on All plans. Per-minute and daily budgets, and the headers reporting remaining quota, are documented in rate limits and credits and billing.

Response fields

FieldTypeDescription
from_station_codestringResolved origin.
to_station_codestringResolved destination.
journey_datestring(date)Requested journey date.
quotaQuotaApplied reservation quota.
trains[].train_numberstringTrain number.
trains[].train_namestringTrain name.
trains[].departure_time / arrival_timestringScheduled segment times in HH:mm.
trains[].duration_minutesintegerSegment duration.
trains[].distance_kmnumber | nullSegment distance.
trains[].train_typestringNormalized train type.
trains[].classesClassCode[]Offered travel classes.
trains[].running_daysRunningDay[]Weekly running pattern.
trains[].has_pantryboolean | nullPantry availability when known.
trains[].on_time_ratingnumber | nullHistorical punctuality rating when available.
trains[].availability_summaryAvailabilityMini[]Compact class-level status, fare, confidence, and update time.

Example response

{
  "success": true,
  "data": {
    "from_station_code": "BSL",
    "to_station_code": "ADI",
    "journey_date": "2026-08-27",
    "quota": "GN",
    "trains": [
      {
        "train_number": "12656",
        "train_name": "Navjeevan SF Express",
        "departure_time": "10:25",
        "arrival_time": "18:00",
        "duration_minutes": 455,
        "classes": [
          "SL",
          "3A",
          "2A",
          "1A"
        ],
        "running_days": [
          "MON",
          "TUE",
          "WED",
          "THU",
          "FRI",
          "SAT",
          "SUN"
        ]
      }
    ]
  },
  "meta": {
    "api_version": "v1",
    "request_id": "req_01J5Z7Y8N2K4M6P8R0T2V4X6Z8",
    "trace_id": "trc_01J5Z7Y8N2K4M6P8R0T2V4X6Z9",
    "timestamp": "2026-08-20T17:12:23.305Z",
    "freshness": {
      "mode": "live",
      "retrieved_at": "2026-08-20T17:12:23.305Z",
      "sources": [
        {
          "confidence": "high"
        }
      ]
    }
  }
}

Errors

StatusCodeDescriptionRetry
404NO_TRAINS_FOUNDNo train matches the route and date.Not retryable
400VALIDATION_ERRORA required field is missing or invalid.Not retryable
401MISSING_API_KEY / INVALID_API_KEYThe credential is absent, unknown, disabled, or expired.Not retryable
403SCOPE_MISSING / PLAN_ENDPOINT_DISABLEDThe key lacks the required scope or plan entitlement.Not retryable
402CREDITS_EXHAUSTEDThe account balance cannot cover this operation.Not retryable
429RATE_LIMITEDMinute or daily request budget is exhausted. Honor Retry-After.Retryable
410API_VERSION_SUNSETThis API version has reached its announced sunset date. Migrate to a supported major version.Not retryable
502UPSTREAM_UNAVAILABLELive data could not be retrieved. Retry with backoff.Retryable
504UPSTREAM_TIMEOUTThe live-data request exceeded its deadline. Retry with backoff.Retryable
503METERING_UNAVAILABLECredit settlement is temporarily unavailable and no data was returned.Retryable

Related Journeys endpoints

All RailCore Indian Railways API endpoints · Quickstart · Rate limits