92ms avg
GET|/api/v1/trains/:trainNo/availability

IRCTC Seat Availability API with 14-Day Calendar

Fetch real-time PRS seat & berth availability across all classes and quotas with a full 14-day continuous calendar forecast in a single request.

Get Free API KeyInteractive PlaygroundAPI Reference

Live Protocol Demo

Production headers and authentic PRS gateway response.

GET/api/v1/trains/12557/availability?from=NKE&to=ANVT&date=17-11-2026&class=3A&quota=GN
curl -X GET "https://api.irctc.dev/api/v1/trains/12557/availability?from=NKE&to=ANVT&date=17-11-2026&class=3A&quota=GN" \
-H "x-api-key: your_api_key"
200 OK·application/json
latency: 92ms avg
{
"success": true,
"trainNumber": "12557",
"trainName": "SAPT KRANTI EXP",
"from": "NKE",
"to": "ANVT",
"date": "17-11-2026",
"class": "3A",
"quota": "GN",
"availability": [
{
"date": "2026-11-17",
"status": "AVAILABLE-0042",
"type": "AVAILABLE",
"currentBooking": "N"
},
{
"date": "2026-11-18",
"status": "GNWL271/WL140",
"type": "WAITLIST",
"currentBooking": "N"
},
{
"date": "2026-11-19",
"status": "GNWL200/WL138",
"type": "WAITLIST",
"currentBooking": "N"
},
{
"date": "2026-11-20",
"status": "GNWL160/WL110",
"type": "WAITLIST",
"currentBooking": "N"
},
{
"date": "2026-11-21",
"status": "AVAILABLE-0018",
"type": "AVAILABLE",
"currentBooking": "N"
}
],
"source": "irctc-api",
"_cached": true,
"_time": 0.092
}

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: 92ms avg
01Edge Ingress
12ms
02Edge Router
< 2ms
03Central PRS Tunnel
92ms avg
Ingress: ~15%Edge: <5%PRS Core: ~80%

Production SLAs & Latency

Deterministic throughput backed by enterprise uptime guarantees.

Latency Benchmark92ms avg
Uptime SLA99.9%
Rate Limits1,000 req/min
Cache Strategy120s Smart Invalidation
01 // Capability

Continuous 14-Day Forecast

Return full two-week availability calendar in one request, eliminating 14 separate round-trips for OTA flight/train comparison screens.

02 // Capability

Multi-Quota Support

Seamless query switching between General (GN), Tatkal (TQ), Premium Tatkal (PT), and Ladies (LD) quotas.

03 // Capability

Current Booking Status

Real-time flag indicating if the train has opened for Current Booking at station counters.

Parameters Specification

Query and path parameters for /api/v1/trains/:trainNo/availability

trainNostringin: PATH
required

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

Example:12557
fromstringin: QUERY
required

Source station code (e.g. NKE).

Example:NKE
tostringin: QUERY
required

Destination station code (e.g. ANVT).

Example:ANVT
datestringin: QUERY
required

Journey date in DD-MM-YYYY format (e.g. 17-11-2026).

Example:17-11-2026
classstringin: QUERY
optional

Travel class code (1A, 2A, 3A, 3E, CC, EC, SL). Defaults to 3A.

Example:3A
quotastringin: QUERY
optional

Reservation quota code (GN = General, TQ = Tatkal, PT = Premium Tatkal, LD = Ladies). Defaults to GN.

Example:GN
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.

Yes. Simply pass quota=TQ in your query parameters to retrieve Tatkal seat availability and waitlist numbers.
Companion Guide

Build a Telegram Alert Bot for Vacant Berths After Chart Preparation

Complement seat availability checks with automated alerts when waitlisted trains open vacant berths post-charting.

Read Tutorial

Related Railway Endpoints

GET /api/v1/trains/:trainNo/chart-vacant

Vacant Berths After Chart Preparation API

Access real-time vacant berths post-charting directly from online reservation charts. Coach-by-coach layout, current booking berths, and TTE allotment data.

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
GET /api/v1/trains/:trainNo/fare

Train Fare & Ticket Pricing API

Fetch real-time train ticket fare breakups across all classes with discrete components: Base Fare, Reservation, Superfast, GST, and Catering.

View endpoint
$npm i irctc-api

Integrate IRCTC Seat Availability API with 14-Day Calendar

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

Get API KeyBrowse 14 Endpoints