54ms avg
GET|/api/v1/live/:trainNo

Live Train Running Status API

Track real-time train running status, current station, GPS delay in minutes, and platform numbers directly from railway telemetry feeds with sub-second execution.

Get Free API KeyInteractive PlaygroundAPI Reference

Live Protocol Demo

Production headers and authentic PRS gateway response.

GET/api/v1/live/12557?date=2026-10-24
curl -X GET "https://api.irctc.dev/api/v1/live/12557?date=2026-10-24" \
-H "x-api-key: your_api_key"
200 OK·application/json
latency: 54ms avg
{
"success": true,
"data": {
"trainNumber": "12557",
"trainName": "Sapt Kranti Exp",
"currentLocation": "Chakia",
"locationStatus": "departed from",
"currentDelayMin": 33,
"currentDelayStr": "+33 min",
"lastUpdated": "24 Oct 2026 12:58",
"totalDistanceKm": 1060,
"totalHalts": 18,
"stops": [
{
"stationName": "Muzaffarpur Jn",
"day": 1,
"arrives": "11:46",
"delayMin": 11,
"status": "passed",
"distanceKm": 0
},
{
"stationName": "Motipur",
"day": 1,
"arrives": "12:10",
"delayMin": 3,
"status": "passed",
"distanceKm": 26
},
{
"stationName": "Chakia",
"day": 1,
"arrives": "12:58",
"delayMin": 33,
"status": "current",
"distanceKm": 48
},
{
"stationName": "Moradabad",
"day": 2,
"arrives": "05:46",
"delayMin": 64,
"status": "upcoming",
"distanceKm": 906
},
{
"stationName": "Anand Vihar TRM",
"day": 2,
"arrives": "09:09",
"delayMin": 89,
"status": "upcoming",
"distanceKm": 1059
}
],
"updatedAt": "2026-10-24T07:38:35.596Z",
"source": "irctc-api"
},
"source": "irctc-api",
"_time": 0.054
}

Engineered for Railway Throughput

High-throughput PRS reservation engine connectivity with sub-second Redis caches and 99.9% uptime reliability.

Direct Gateway Architecture

Multi-hop routing & telemetry
Dedicated PRS Socket

Queries route through high-speed edge clusters across Indian data center zones with direct PRS gateway connectivity and sub-millisecond dispatch.

HOP_TELEMETRY // DEDICATED_SOCKETTOTAL_BUDGET: 54ms avg
01Edge Ingress
12ms
02Edge Router
< 2ms
03Central PRS Tunnel
54ms avg
Ingress: ~15%Edge: <5%PRS Core: ~80%

Production SLAs & Latency

Deterministic throughput backed by enterprise uptime guarantees.

Latency Benchmark54ms avg
Uptime SLA99.95%
Rate Limits1,000 req/min
Cache Strategy45s Real-Time Buffer
01 // Capability

Passed vs Upcoming Halts

Clean discrete status classification ("passed", "current", "upcoming") for rendering intuitive progress bars and travel timelines.

02 // Capability

Precision Delay Minutes

Integer delay (e.g. 33) and formatted strings ("+33 min") for effortless calculation of expected arrival times.

03 // Capability

Zero Latency Telemetry Buffer

Edge-cached telemetry prevents upstream rate-limits while delivering fresh updates every 45-60 seconds.

Parameters Specification

Query and path parameters for /api/v1/live/:trainNo

trainNostringin: PATH
required

5-digit Indian Railways train number (e.g. 12557).

Example:12557
datestringin: QUERY
optional

Journey start date in YYYY-MM-DD format (defaults to current date).

Example:2026-10-24
Response Status:
200 OK 400 Bad Request 404 Not Found 503 Upstream Maintenance

Frequently Asked Questions

Technical specs regarding IRCTC session lifetime, authentication, and quotas.

Location data refreshes continuously from railway GPS transponders and station passing records every 45 to 60 seconds.
WhatsApp Bot Tutorial

How to Build a WhatsApp Train Running Status & PNR Bot in Node.js

Complete tutorial on building an automated WhatsApp bot for Indian Railways live train status and PNR checks using Baileys and Node.js.

Read Tutorial

Related Railway Endpoints

GET /api/v1/trains/:trainNo

Train Schedule & Route Halts API

Fetch the complete timetable for any 5-digit Indian Railways train: sequential station halts, arrival/departure timings, halt durations, distance, and lat/long coordinates.

View endpoint
GET /api/v1/trains/search

Trains Between Stations API

Search all running trains between any two Indian Railways station codes with travel duration, running days, distance, halts, and base fares.

View endpoint
GET /api/v1/pnr/:pnr

Real-Time PNR Status API

Sub-100ms Indian Railways passenger confirmation, coach & berth allocation, and chart preparation status with zero scraping headaches.

View endpoint
$npm i irctc-api

Integrate Live Train Running Status API

Integrate live Indian Railways data into your production or staging stack. 10,000 free sandbox calls included.

Get API KeyBrowse 14 Endpoints