Indian Railways API

A simple, powerful, and unofficial API to get accurate Indian Railway data for trains, PNR status, live status, and more.

Features • Endpoints • Installation • Usage

--- ## 🔍 Overview The **Indian Railways API** is a fast, developer-friendly, and unofficial wrapper that scrapes various sources to deliver complete and structured information for Indian Railway services. It’s ideal for travel apps, dashboards, or any tool needing real-time railway data without the hassle of direct scraping. No sign-ups, no API keys — just hit the endpoints and get structured, ready-to-use JSON data. 🚀 --- ## 📦 Features This API packs a comprehensive suite of features for all your railway data needs: - 🚂 **Train Details:** Fetch train name, number, and complete schedule. - 🛤️ **Station-wise Route:** Get a detailed list of all stations on a train's route. - 📍 **Live Status:** Track the real-time location and status of any running train. - 🎟️ **PNR Status:** Check the current status of any PNR number. - ↔️ **Trains Between Stations:** Find all available trains between two stations on a specific date. - 👨‍👩‍👧‍👦 **Coach Position:** Find the coach composition and position from the engine. - 🕒 **Delay History:** Analyze a train's punctuality with historical delay data.
- ⚠️ **Friendly Error Messages:** Clear and helpful errors for invalid inputs. - 🔒 **Secure & Open:** CORS-enabled, versioned, and ready to be integrated. --- ## 📬 API Endpoints All endpoints are prefixed with `/api/v1`. The base URL will be your deployment URL (e.g., `http://localhost:3000`). ### Train Information ## 📌 Available Endpoints ### 1. Get Train Details Fetches complete route and schedule for a specific train. - **GET /train-details** - **POST /train-details** | Parameter | Type | Required | Location | Description | |-----------|--------|----------|--------------|----------------------------------| | `trainNo` | string | ✅ Yes | Query / Body | 5-digit train number (e.g., 12951) | 📌 **Example:** ``` GET /train-details?trainNo=12951 ``` --- ### 2. PNR Status Get the status of a ticket using a PNR number. - **GET /pnr-status** | Parameter | Type | Required | Description | |-----------|--------|----------|---------------------| | `pnrNo` | string | ✅ Yes | 10-digit PNR number | 📌 **Example:** ``` GET /pnr-status?pnrNo=1234567890 ``` --- ### 3. Trains Between Stations Fetch trains running between two stations on a specific date. - **GET /trains-between-stations** | Parameter | Type | Required | Description | |------------------|--------|----------|---------------------------------| | `startStationCode` | string | ✅ Yes | Source station code (e.g., RJT) | | `endStationCode` | string | ✅ Yes | Destination station code (e.g., ADI) | | `date` | string | ✅ Yes | Travel date in dd-mm-yyyy | 📌 **Example:** ``` GET /trains-between-stations?startStationCode=RJT&endStationCode=ADI&date=23-06-2025 ``` --- ### 4. Live Train Status Get live running status of a train. - **GET /live-train-status** | Parameter | Type | Required | Description | |-----------|--------|----------|------------------------------------------------| | `trainNo` | string | ✅ Yes | Train number (5 digits) | | `startDay`| number | ❌ No | 0 to 4 depending on how many days ago it started | 📌 **Example:** ``` GET /live-train-status?trainNo=12902&startDay=1 ``` --- ### 5. Train Coach Data Get coach composition of a train. - **GET /train-coach-data** | Parameter | Type | Required | Description | |-----------|--------|----------|-----------------------------| | `trainNo` | string | ✅ Yes | Train number (e.g., 22959) | 📌 **Example:** ``` GET /train-coach-data?trainNo=22959 ``` --- ### 6. Train Delay History Check the average delay of a train over a specific time period. - **GET /train-delay-history** | Parameter | Type | Required | Description | |-----------|--------|----------|-----------------------------------------------------------------------------| | `trainNo` | string | ✅ Yes | Train number | | `period` | string | ❌ No | One of `thisweek`, `thismonth`, `lastmonth`, `thisyear`, `lastyear` | 📌 **Example:** ``` GET /train-delay-history?trainNo=22959&period=thismonth ``` --- --- #IndianRailways #IRCTC #API #Developer #Tech #Programming #OpenSource #RESTAPI #WebDevelopment #TrainTravel #PNRStatus #LiveTrainStatus #TravelTech #Coding #Backend #DataScraping #JSON #Automation #BuildInPublic #DevCommunity #TechForGood #DigitalIndia #StartupIndia #NodeJS #Python #PublicTransport #SmartIndia #TrainsInIndia #RailwayAPI #TechInnovation#IndianRailways #IRCTC #TrainTravel #PNRStatus #LiveTrainStatus #API #RESTAPI #Developer #WebDevelopment #OpenSource #TechInnovation #TravelTech #DataScraping #Automation ## ⚠️ Disclaimer This API is for educational and personal use only. It is not affiliated with IRCTC or Indian Railways. Use responsibly.