Batch seat availability

Check up to 25 train and class combinations.

POST /v1/availability/seats/batch

Scope availability:read · Credits max(5, 2 x item/class combinations) · Plans All plans

Returns independent availability results for every item. Pricing is dynamic based on each requested item and class.

Authentication

Send your key in the X-RailCore-Key header. This operation requires the availability:read scope. See the authentication guide.

Request parameters

This operation takes no path or query parameters.

JSON body

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

curl -sS -X POST \
  -H "X-RailCore-Key: $RAILCORE_KEY" \
  -H "Content-Type: application/json" \
  --data '{"items":[{"train_number":"12656","from":"BSL","to":"ADI","date":"2026-08-27","classes":["SL","3A"],"quota":"GN"},{"train_number":"12952","from":"NDLS","to":"BCT","date":"2026-08-28","classes":["2A"],"quota":"TQ"}]}' \
  "https://ir.railcore.tech/v1/availability/seats/batch"

JavaScript

const response = await fetch("https://ir.railcore.tech/v1/availability/seats/batch", {
  method: "POST",
  headers: {
    "X-RailCore-Key": process.env.RAILCORE_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "items": [
    {
      "train_number": "12656",
      "from": "BSL",
      "to": "ADI",
      "date": "2026-08-27",
      "classes": [
        "SL",
        "3A"
      ],
      "quota": "GN"
    },
    {
      "train_number": "12952",
      "from": "NDLS",
      "to": "BCT",
      "date": "2026-08-28",
      "classes": [
        "2A"
      ],
      "quota": "TQ"
    }
  ]
}),
});

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

Python

import json
import os
import requests

response = requests.request(
    "POST",
    "https://ir.railcore.tech/v1/availability/seats/batch",
    headers={"X-RailCore-Key": os.environ["RAILCORE_KEY"]},
    json=json.loads("{\"items\":[{\"train_number\":\"12656\",\"from\":\"BSL\",\"to\":\"ADI\",\"date\":\"2026-08-27\",\"classes\":[\"SL\",\"3A\"],\"quota\":\"GN\"},{\"train_number\":\"12952\",\"from\":\"NDLS\",\"to\":\"BCT\",\"date\":\"2026-08-28\",\"classes\":[\"2A\"],\"quota\":\"TQ\"}]}"),
    timeout=20,
)
print(response.status_code, response.json())

Rate limits and credits

This call costs max(5, 2 x item/class combinations) credits and is available on All plans. Per-minute and daily budgets, and the headers reporting remaining quota, are documented in rate limits and credits and billing.

Response fields

Example response

{
  "success": true,
  "data": {
    "results": [
      {
        "train_number": "12656",
        "from_station_code": "BSL",
        "to_station_code": "ADI",
        "journey_date": "2026-08-27",
        "quota": "GN",
        "classes": [
          {
            "class_code": "3A",
            "status": "AVAILABLE",
            "availability_text": "AVAILABLE 24",
            "available_count": 24,
            "waitlist_count": 0,
            "rac_count": 0,
            "wl_pool": null,
            "fare": 1125,
            "total_fare": 1125,
            "confirmation_probability": {
              "percentage": 96,
              "label": "HIGH",
              "text": "High confirmation likelihood"
            },
            "last_updated_at": "2026-08-20T17:12:23.304Z"
          }
        ]
      }
    ]
  },
  "meta": {
    "api_version": "v1",
    "request_id": "req_01J5Z7Y8N2K4M6P8R0T2V4X6Z8",
    "trace_id": "trc_01J5Z7Y8N2K4M6P8R0T2V4X6Z9",
    "timestamp": "2026-08-20T17:12:23.305Z",
    "freshness": {
      "mode": "live",
      "retrieved_at": "2026-08-20T17:12:23.305Z",
      "sources": [
        {
          "confidence": "high"
        }
      ]
    }
  }
}

Errors

Related Availability endpoints

• Seat availability
• Availability calendar
• Available classes

All RailCore Indian Railways API endpoints · Quickstart · Rate limits