Developer API, v1

Indian Railways API documentation

Live train status, schedules, stations, seat availability, fares, chart intelligence, and async analysis through one authenticated v1 API.

GET/v1/trains/12723/live?date=2026-11-20

12723 Telangana Express

Running 23 minutes late

Run of 2026-11-20 · last reported 11:34 · 13 s old

HYBNDLS

At or past Makudi · 336 of 1,675 km · due NDLS 08:07

SKZRSirpur Kaghaznagar10:3911:17PF 1
BPQBalharshah11:5512:01PF 4
NDLSNew Delhi07:4508:07

and 2 more stations in the response

The example answer from Live train status, drawn. Every endpoint page shows its response as JSON and, where a picture says more, like this.

Start here

Base URL

v1 has one production environment. There is no sandbox in the current major.

https://ir.railcore.tech/v1

First request

Every operation needs your API key, in X-RailCore-Key, Authorization: Bearer or X-Api-Key: pick the header on the sample. Store the key in an environment variable, not source code.

Terminal
curl -sS \
  -H "X-RailCore-Key: $RAILCORE_KEY" \
  "https://ir.railcore.tech/v1/stations/search?q=bhusaval&limit=5"

Growth, Scale and Enterprise keys must sign

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. Without a signature their requests answer 401 SIGNATURE_INVALID. How to sign a request.

API map

30 operations in 7 groups. The reference lists every operation an API key can call, including the async job operations.

How the API behaves

Live by default
Responses use no-store headers and include freshness metadata. Do not treat live train or availability data as static.
Failed requests are free
Only successful 2xx responses are counted, and most requests count as one. See plans and costs.
Null means unknown
A field the API cannot establish for a run is null. It is never filled in from the timetable.
Codes are the contract
Messages can be reworded; error.code stays. Every code is in one catalog.

Plans and terms

What each plan includes and costs, and the terms every API key is used under.

Last updated