Seat availability

Check availability afresh for one train and class.

GET /v1/availability/seats

Scope availability:read · Cost 1 request · Plans All plans

Asks afresh on every request, with no RailCore cache, and returns normalized availability, waitlist pool, fare, prediction, and when the figure was read.

Authentication

Send your key in one header: X-RailCore-Key, Authorization: Bearer or X-Api-Key. Two headers with different keys answer 401 AMBIGUOUS_API_KEY. This operation requires the availability:read scope. 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. See the authentication guide and HMAC signing.

Request parameters

NameInTypeRequiredDescription
train_numberquerystringRequiredTrain number, 4 to 6 uppercase letters or digits.
fromquerystringRequiredBoarding station code.
toquerystringRequiredDestination station code.
datequerystring(date)RequiredJourney date in YYYY-MM-DD format.
classquerystringRequiredTravel class code.
quotaquerystringOptionalReservation quota. Seat availability answers GN (General), TQ (Tatkal), SS (Lower berth / senior citizen) and LD (Ladies). Any other quota, Premium Tatkal (PT) included, is refused for every train with 422 QUOTA_NOT_SUPPORTED before the seat provider is asked, and is not counted.

Code examples

Base URL https://ir.railcore.tech/v1. Keep the key in an environment variable and call from a trusted server-side environment.

cURL

JOURNEY_DATE=$(date -u -d "+7 days" +%F 2>/dev/null || date -u -v+7d +%F)

curl -sS -X GET \
  -H "X-RailCore-Key: $RAILCORE_KEY" \
  "https://ir.railcore.tech/v1/availability/seats?train_number=12656&from=BSL&to=ADI&date=$JOURNEY_DATE&class=3A&quota=GN"

JavaScript

const journeyDate = new Date(Date.now() + 7 * 86_400_000).toISOString().slice(0, 10);

const response = await fetch(`https://ir.railcore.tech/v1/availability/seats?train_number=12656&from=BSL&to=ADI&date=${journeyDate}&class=3A&quota=GN`, {
  method: "GET",
  headers: {
    "X-RailCore-Key": process.env.RAILCORE_KEY,
  },
});

const body = await response.json();
console.log(response.status, body);

Python

import datetime
import os
import requests

journey_date = (datetime.date.today() + datetime.timedelta(days=7)).isoformat()

response = requests.request(
    "GET",
    f"https://ir.railcore.tech/v1/availability/seats?train_number=12656&from=BSL&to=ADI&date={journey_date}&class=3A&quota=GN",
    headers={"X-RailCore-Key": os.environ["RAILCORE_KEY"]},
    timeout=20,
)
print(response.status_code, response.json())

Rate limits and cost

This operation counts as 1 request and is available on all plans. Failed requests are free. Per-minute budgets, daily caps and the headers reporting what is left are in rate limits; plans and prices are in requests and billing.

Response fields

FieldTypeDescription
train_numberstringTrain number.
from_station_code / to_station_codestringRequested segment.
journey_datestring(date)Requested journey date.
quotaQuotaApplied quota.
classes[].class_codeClassCodeTravel class.
classes[].statusstringAVAILABLE, RAC, WAITLIST, REGRET, NOT_AVAILABLE, TRAIN_CANCELLED, TRAIN_DEPARTED, or UNKNOWN.
classes[].availability_textstringSource availability text normalized for display.
classes[].available_countinteger | nullAvailable berth count; null when the source reports availability without a quantity.
classes[].waitlist_count / rac_countinteger | nullCurrent waitlist and RAC positions; null when the active status has no reported position.
classes[].wl_pool / wl_pool_positionstring / integerOriginal booking pool and position, read from the availability text (GNWL276/WL185 gives GNWL and 276). Present only when the text names the pool; left out otherwise. They can stay after the current status becomes RAC or available. Compatibility codes are preserved exactly, without inferred quota descriptions.
classes[].fare / total_fareinteger | nullFare values in INR. total_fare is what the ticket costs; fare is total_fare less catering_charge.
classes[].catering_chargeintegerCatering included in total_fare, in INR. 0 on a train without compulsory catering.
classes[].fare_breakdownobject | absentThe railway's split of total_fare in INR: base_fare, reservation_charge, superfast_charge, tatkal_charge, dynamic_fare, fuel_charge, other_charge, gst, catering_charge, rounding (what the railway added to reach the next ₹5, 0 to 4) and concession (subtracted). The parts always add up to total_fare; a null part was not given. Absent when the enquiry gave no split.
classes[].confirmation_probabilityobject | nullThe chance that a ticket booked now is confirmed: percentage, a LOW/MEDIUM/HIGH label and text. 100 (Available) when seats are available; 0 with the reason in text when no ticket can be booked (Waitlist full (regret) for a REGRET class, whose waitlist is full and can reopen as tickets are cancelled; not available; train departed or cancelled); the forecast for a waitlisted or RAC ticket. Null only for a waitlisted or RAC class with no forecast.
classes[].last_updated_atstring | nullWhen the figure was read at the source. It can be hours before your request when the upstream answers from its own cache, so use it to evaluate freshness.

Example response

{
  "success": true,
  "data": {
    "train_number": "12656",
    "from_station_code": "BSL",
    "to_station_code": "ADI",
    "journey_date": "2026-11-27",
    "quota": "GN",
    "classes": [
      {
        "class_code": "3A",
        "status": "AVAILABLE",
        "availability_text": "AVAILABLE-4",
        "available_count": 4,
        "waitlist_count": 0,
        "rac_count": 0,
        "fare": 965,
        "catering_charge": 0,
        "total_fare": 965,
        "fare_breakdown": {
          "base_fare": 834,
          "reservation_charge": 40,
          "superfast_charge": 45,
          "tatkal_charge": 0,
          "dynamic_fare": 0,
          "fuel_charge": 0,
          "other_charge": 0,
          "gst": 46,
          "catering_charge": 0,
          "concession": 0,
          "rounding": 0
        },
        "confirmation_probability": {
          "percentage": 100,
          "label": "HIGH",
          "text": "Available"
        },
        "last_updated_at": "2026-11-20T08:15:46.547+05:30"
      }
    ]
  },
  "meta": {
    "api_version": "v1",
    "request_id": "req_01J5Z7Y8N2K4M6P8R0T2V4X6Z8",
    "trace_id": "trc_01J5Z7Y8N2K4M6P8R0T2V4X6Z9",
    "timestamp": "2026-11-20T10:57:05.609Z",
    "freshness": {
      "mode": "live",
      "retrieved_at": "2026-11-20T10:57:05.609Z",
      "sources": [
        {
          "confidence": "high"
        }
      ]
    }
  }
}

Errors

StatusCodeDescriptionRetry
422TATKAL_NOT_OPENTatkal booking has not opened for the journey yet. error.opens_at (IST) says when, if known. Not counted.Not retryable
422QUOTA_NOT_SUPPORTEDSeat availability is not offered for that quota on any train: it answers GN, TQ, SS and LD only. Premium Tatkal (PT), HP, DP, HO, YU and FT can be checked on IRCTC. RailCore refuses it before the seat provider is asked. Not counted.Not retryable
422QUOTA_NOT_AVAILABLEThe train does not offer that quota in that class for the journey. Not counted.Not retryable
422CLASS_NOT_AVAILABLEThe train does not carry that class. error.message lists the classes it does. Not counted.Not retryable
422TRAIN_NOT_RUNNINGThe train does not leave the boarding station on that date. error.message lists the days it does. Not counted.Not retryable
422BOOKING_NOT_OPENThe date has not opened for booking: reservations open 60 days before the journey, at 8:00 AM in India. RailCore refuses it before the seat provider is asked. error.message names the day it opens. Not counted.Not retryable
400VALIDATION_ERRORA required field is missing or invalid. error.details[].field names the parameter, such as date or items[2].date.Not retryable
401MISSING_API_KEYNo key in X-RailCore-Key, Authorization: Bearer or X-Api-Key, or the key is too short.Not retryable
401INVALID_API_KEYThe key is unknown or revoked. A disabled or expired key answers API_KEY_DISABLED or API_KEY_EXPIRED.Not retryable
401AMBIGUOUS_API_KEYMore than one key header was sent, with different keys. Send the key in one header.Not retryable
401SIGNATURE_INVALIDHMAC signature missing or not verified. Growth, Scale and Enterprise keys must sign every request; a key with no signing secret must be rotated.Not retryable
403SCOPE_MISSINGThe key lacks this operation's scope.Not retryable
403PLAN_ENDPOINT_DISABLEDThe account's plan does not include this endpoint.Not retryable
402CREDITS_EXHAUSTEDThe month's requests are used up, or too few are left for this request. Nothing is fetched.Not retryable
429RATE_LIMITEDThe account's per-minute budget, or a Free account's daily budget, is used up. Every key on the account shares it. Honor Retry-After.Retryable
410API_VERSION_SUNSETThis API version has reached its announced sunset date. Migrate to a supported major version.Not retryable
503UPSTREAM_UNAVAILABLELive data could not be retrieved. Wait for Retry-After, then retry with backoff. Not counted.Retryable
503UPSTREAM_TIMEOUTThe live-data request ran past its deadline. Wait for Retry-After, then retry with backoff. Not counted.Retryable
503METERING_UNAVAILABLEThe request could not be counted, so no data was returned. Retry with backoff.Retryable

Implementation notes

Related Availability endpoints

All RailCore Indian Railways API endpoints · Quickstart · Rate limits

Last updated