DEV Community: Manjot Singh

How to Check Indian Railway PNR Status Programmatically (Node.js & Python Guide)

Manjot Singh — Sat, 31 Oct 2026 06:40:36 +0000

Original Guide: This article was originally published on IRCTC Developer Platform.

Checking the status of an Indian Railways Passenger Name Record (PNR) programmatically has historically been frustrating: brittle web scrapers, OCR-based captcha captchas, and random IP bans.

In this guide, we'll cover how to query official CRIS PRS live PNR records in under 100ms using Node.js and Python with zero scraping maintenance.

Anatomy of a 10-Digit PNR

A PNR number consists of:

First 3 Digits: PRS Reservation Zone (e.g., 226 for Northern Railway CRIS PRS).
Last 7 Digits: Unique transaction serial number.

Method 1: Node.js & TypeScript with `irctc-api`

The official client SDK handles authentication, keep-alive connections, and TypeScript types out of the box.

Installation

npm install irctc-api

Code

import { IrctcApi } from 'irctc-api';

const client = new IrctcApi({
  apiKey: process.env.IRCTC_API_KEY || 'irctc_live_9a8f2c7e01d4'
});

async function verifyBooking(pnrNumber: string) {
  try {
    const pnr = await client.pnr.check(pnrNumber);

    console.log(`🚆 Train: ${pnr.trainNumber} - ${pnr.trainName}`);
    console.log(`🛣️ Route: ${pnr.from} -> ${pnr.to} | Date: ${pnr.doj}`);
    console.log(`📊 Chart Status: ${pnr.chartStatus}`);

    pnr.passengers.forEach((p, idx) => {
      console.log(`  • Passenger ${idx + 1}: ${p.currentStatus} | Coach: ${p.coach || 'N.A'} | Berth: ${p.berthNumber || 'N.A'} [${p.berth || 'N.A'}]`);
    });
  } catch (error: any) {
    console.error('PNR verification error:', error.message);
  }
}

verifyBooking('2265248473');

Method 2: Python with `requests`

If you are building in Python (Django, Flask, FastAPI, Celery):

Installation

pip install requests

Code

import os
import requests

API_KEY = os.getenv("IRCTC_API_KEY", "irctc_live_9a8f2c7e01d4")
PNR = "2265248473"

url = f"https://api.irctc.dev/api/v1/pnr/{PNR}"
headers = {
    "x-api-key": API_KEY,
    "accept": "application/json",
    "User-Agent": "pnr-client/v1.0"
}

response = requests.get(url, headers=headers, timeout=5.0)

if response.status_code == 200:
    data = response.json().get("data", {})
    print(f"Train: {data.get('trainNumber')} - {data.get('trainName')}")
    print(f"Date: {data.get('doj')} ({data.get('from')} -> {data.get('to')})")
    print(f"Chart: {data.get('chartStatus')}")

    for idx, p in enumerate(data.get("passengers", []), 1):
        print(f"  P{idx}: {p.get('currentStatus')} | Coach: {p.get('coach', 'N.A')} | Seat: {p.get('berthNumber', 'N.A')} [{p.get('berth', 'N.A')}]")
else:
    print(f"Error {response.status_code}: {response.text}")

Understanding Passenger Fields

Field	Description	Values
`currentStatus`	Current booking status	`CNF`, `RAC 12`, `WL 45`
`coach`	Reserved coach	`B2`, `S4`, `M1`, `N.A`
`berthNumber`	Specific berth number	`18`, `45`, `N.A`
`berth`	Clean normalized berth type	`LOWER BERTH`, `MIDDLE BERTH`, `UPPER BERTH`, `SIDE LOWER`, `SIDE UPPER`
`chartStatus`	PRS charting status	`CHART NOT PREPARED`, `CHART PREPARED`

Recommended Polling Schedule (Smart Backoff)

Do NOT poll PNR every few seconds. PNR statuses only update upon ticket cancellation or chart preparation.

> 48 hours to departure: Poll once every 24 hours.
12 – 48 hours to departure: Poll every 4 hours.
< 4 hours to departure: Poll every 15 minutes to catch chart preparation.

Resources

Interactive PNR Sandbox: https://irctc.dev/playground
Standalone PNR API Guide: https://irctc.dev/pnr-status-api
Official NPM SDK: https://www.npmjs.com/package/irctc-api

How to Build a Real-Time WhatsApp Train Tracking & PNR Bot in Node.js (2026 Tutorial)

Manjot Singh — Thu, 29 Oct 2026 13:02:26 +0000

Original Resource: This guide is officially published on the IRCTC Developer Platform.

Have you ever been stuck at a railway platform frantically refreshing slow apps to find out where your train is or whether your RAC/WL ticket confirmed?

In this tutorial, we will build a production-ready WhatsApp bot in Node.js & TypeScript that lets you check live train running status, delay minutes, and 10-digit PNR status directly in WhatsApp with zero Twilio or Meta WhatsApp Business API costs.

Architecture Overview

User sends WhatsApp message (!live 12557)
    │
    ▼
[@whiskeysockets/baileys Multi-Device Socket]
    │
    ▼
Command Parser (!live <train> | !pnr <pnr>)
    │
    ▼
[IRCTC API Gateway: https://api.irctc.dev]
    │
    ▼
Formatted WhatsApp Response (Delays, Halts, Coach & Berths)

Prerequisites

Node.js 18+ LTS installed on your system.
A mobile phone with WhatsApp installed to scan the QR code.
A free IRCTC API Key from irctc.dev/dashboard (every developer receives 10,000 free requests upon 1-click Google signup with zero credit card required).

Step 1: Initialize Project & Install Dependencies

Create a new directory and install @whiskeysockets/baileys (for WhatsApp Web multi-device connection), qrcode-terminal, irctc-api, and dotenv:

mkdir irctc-whatsapp-bot && cd irctc-whatsapp-bot
npm init -y
npm install @whiskeysockets/baileys qrcode-terminal irctc-api dotenv
npm install -D typescript @types/node ts-node
npx tsc --init

Step 2: Configure Environment Variables

Create a .env file in your root folder:

IRCTC_API_KEY=your_irctc_api_key_here
BOT_PREFIX=!
NODE_ENV=production

Step 3: Implement WhatsApp Socket & Railway Commands

Create src/index.ts and set up the Baileys socket with persistent multi-file authentication so you only have to scan the QR code once:

import makeWASocket, {
  DisconnectReason,
  useMultiFileAuthState
} from '@whiskeysockets/baileys';
import { Boom } from '@hapi/boom';
import qrcode from 'qrcode-terminal';
import { IrctcApi } from 'irctc-api';
import dotenv from 'dotenv';

dotenv.config();

const irctc = new IrctcApi({
  apiKey: process.env.IRCTC_API_KEY || ''
});

async function startBot() {
  const { state, saveCreds } = await useMultiFileAuthState('auth_info_baileys');

  const sock = makeWASocket({
    auth: state,
    printQRInTerminal: false
  });

  sock.ev.on('connection.update', (update) => {
    const { connection, lastDisconnect, qr } = update;
    if (qr) {
      console.log('⚡ Scan this QR code with WhatsApp on your phone:');
      qrcode.generate(qr, { small: true });
    }
    if (connection === 'close') {
      const shouldReconnect =
        (lastDisconnect?.error as Boom)?.output?.statusCode !== DisconnectReason.loggedOut;
      if (shouldReconnect) startBot();
    } else if (connection === 'open') {
      console.log('✅ IRCTC WhatsApp Bot is online!');
    }
  });

  sock.ev.on('creds.update', saveCreds);

  // Incoming Message Handler
  sock.ev.on('messages.upsert', async ({ messages, type }) => {
    if (type !== 'notify') return;
    const msg = messages[0];
    if (!msg.message || msg.key.fromMe) return;

    const sender = msg.key.remoteJid!;
    const text =
      msg.message.conversation ||
      msg.message.extendedTextMessage?.text ||
      '';

    const trimmed = text.trim();

    // 1. Live Running Status Command (!live 12557)
    if (trimmed.startsWith('!live ')) {
      const trainNo = trimmed.replace('!live ', '').trim();
      try {
        await sock.sendMessage(sender, { text: `🔍 Checking live status for ${trainNo}...` });
        const live = await irctc.live.getStatus(trainNo);

        const reply = `🚆 *Train ${live.trainNumber} — ${live.trainName}*
📍 *Current Location:* ${live.currentLocation} (${live.locationStatus})
⏱️ *Status:* ${live.currentDelayMin > 0 ? `Delayed by ${live.currentDelayMin} mins 🔴` : 'Running On Time 🟢'}
🎯 *Next Station:* ${live.stops?.find((s: any) => s.status === 'upcoming')?.stationName || 'In Transit'}

⚡ _Powered by irctc.dev_`;

        await sock.sendMessage(sender, { text: reply });
      } catch (err: any) {
        await sock.sendMessage(sender, { text: `❌ ${err.message}` });
      }
    }

    // 2. Real-Time PNR Status Command (!pnr 2265248473)
    if (trimmed.startsWith('!pnr ')) {
      const pnr = trimmed.replace('!pnr ', '').trim();
      try {
        await sock.sendMessage(sender, { text: `🔍 Verifying PNR ${pnr}...` });
        const data = await irctc.pnr.check(pnr);

        const passengerList = (data.passengers || [])
          .map((p: any, i: number) => `  • P${i + 1}: *${p.currentStatus}* (Coach ${p.coach || 'N.A'}, Seat ${p.berthNumber || 'N.A'} [${p.berth || 'N.A'}])`)
          .join('\n');

        const reply = `🎫 *IRCTC PNR Status: ${pnr}*
🚆 *Train:* ${data.trainNumber} - ${data.trainName}
🗓️ *Date:* ${data.journeyDate} (${data.from?.code} ➔ ${data.to?.code})
📊 *Charting:* ${data.chartStatus}

👥 *Passenger Manifest:*
${passengerList}

⚡ _Powered by irctc.dev_`;

        await sock.sendMessage(sender, { text: reply });
      } catch (err: any) {
        await sock.sendMessage(sender, { text: `❌ ${err.message}` });
      }
    }
  });

  return sock;
}

startBot();

Step 4: Run the Bot

Start your bot in development:

npx ts-node src/index.ts

Scan the terminal QR code using WhatsApp on your phone (Linked Devices ➔ Link a Device).
Once connected, open any WhatsApp chat and send:
- !live 12557 (Fetches live GPS status, platform, and delay in under 400ms).
- !pnr 2265248473 (Fetches passenger coach and berth allocations).

Test it right now in your terminal (No code required)

If you want to test the underlying Indian Railways API directly without setting up WhatsApp, run:

npx irctc-api live 12557
npx irctc-api pnr 2265248473

You can claim 10,000 free requests directly at irctc.dev/dashboard.

DEV Community: Manjot Singh

How to Check Indian Railway PNR Status Programmatically (Node.js & Python Guide)

Anatomy of a 10-Digit PNR

Method 1: Node.js & TypeScript with irctc-api

Installation

Code

Method 2: Python with requests

Installation

Code

Understanding Passenger Fields

Recommended Polling Schedule (Smart Backoff)

Resources

How to Build a Real-Time WhatsApp Train Tracking & PNR Bot in Node.js (2026 Tutorial)

Architecture Overview

Prerequisites

Step 1: Initialize Project & Install Dependencies

Step 2: Configure Environment Variables

Step 3: Implement WhatsApp Socket & Railway Commands

Step 4: Run the Bot

Test it right now in your terminal (No code required)

Method 1: Node.js & TypeScript with `irctc-api`

Method 2: Python with `requests`