Vacant berth hopping

Build a same-train berth chain when no berth covers the full route.

GET /v1/charts/vacant-berths/hopping

Scope charts:read · Credits 10 · Plans Scale and Enterprise

Combines chart data, schedule, coach position, preferences, optional fares, alternate boarding, and multiple optimization strategies.

Authentication

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

Request parameters

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 GET \
  -H "X-RailCore-Key: $RAILCORE_KEY" \
  "https://ir.railcore.tech/v1/charts/vacant-berths/hopping?train_number=12656&from=BSL&to=ADI&date=2026-08-27&via=JL%2CAN&max_hops=6&prefer_berth=LB%2CSLB&avoid_berth=UB%2CSUB&prefer_class=SL%2C3A&avoid_class=1A&include_fare=false&include_alternate_boarding=false&strategies=min_hops%2Ccheapest&alternate_boarding_mode=lightweight&alternate_boarding_max_candidates=3&include_cross_class=false"

JavaScript

const response = await fetch("https://ir.railcore.tech/v1/charts/vacant-berths/hopping?train_number=12656&from=BSL&to=ADI&date=2026-08-27&via=JL%2CAN&max_hops=6&prefer_berth=LB%2CSLB&avoid_berth=UB%2CSUB&prefer_class=SL%2C3A&avoid_class=1A&include_fare=false&include_alternate_boarding=false&strategies=min_hops%2Ccheapest&alternate_boarding_mode=lightweight&alternate_boarding_max_candidates=3&include_cross_class=false", {
  method: "GET",
  headers: {
    "X-RailCore-Key": process.env.RAILCORE_KEY,
  },
});

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

Python

import os
import requests

response = requests.request(
    "GET",
    "https://ir.railcore.tech/v1/charts/vacant-berths/hopping?train_number=12656&from=BSL&to=ADI&date=2026-08-27&via=JL%2CAN&max_hops=6&prefer_berth=LB%2CSLB&avoid_berth=UB%2CSUB&prefer_class=SL%2C3A&avoid_class=1A&include_fare=false&include_alternate_boarding=false&strategies=min_hops%2Ccheapest&alternate_boarding_mode=lightweight&alternate_boarding_max_candidates=3&include_cross_class=false",
    headers={"X-RailCore-Key": os.environ["RAILCORE_KEY"]},
    timeout=20,
)
print(response.status_code, response.json())

Rate limits and credits

This call costs 10 credits and is available on Scale and Enterprise. 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": {
    "train_number": "12656",
    "train_name": "Navjeevan SF Express",
    "from_station_code": "BSL",
    "to_station_code": "ADI",
    "train_start_date": "2026-08-27",
    "chart_status": {
      "chart_one_prepared": true,
      "chart_two_prepared": true
    },
    "direct": {
      "available": false,
      "options": []
    },
    "hopping": {
      "disabled": false,
      "disabled_reason": null,
      "options": [
        {
          "class_code": "3A",
          "is_covered": true,
          "total_hops": 2,
          "physical_seat_changes": 1,
          "total_fare_inr": 1190,
          "hops": [
            {
              "from_station_code": "BSL",
              "to_station_code": "AN",
              "coach_name": "B1",
              "class_code": "3A",
              "berth_number": 17,
              "berth_code": "L",
              "fare_inr": 610
            },
            {
              "from_station_code": "AN",
              "to_station_code": "ADI",
              "coach_name": "B2",
              "class_code": "3A",
              "berth_number": 28,
              "berth_code": "SL",
              "fare_inr": 580
            }
          ]
        }
      ]
    },
    "alternate_boarding": {
      "enabled": false,
      "candidates": []
    },
    "cross_class": {
      "enabled": false,
      "plan": null
    },
    "_meta": {
      "classes_requested": [
        "3A"
      ],
      "max_hops": 6,
      "partial_failures": []
    }
  },
  "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 Charts endpoints

• Chart status
• Vacant berths
• Route vacancy scan

All RailCore Indian Railways API endpoints · Quickstart · Rate limits