Unreserved fare

Query UTS journey and season-ticket fares.

GET /v1/fares/unreserved

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

Returns one or more unreserved fare routes for passenger counts, train category, class, and ticket duration.

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 fares: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
fromquerystringRequiredBoarding station code.
toquerystringRequiredDestination station code.
datequerystring(date)OptionalJourney date in YYYY-MM-DD format: today, tomorrow or the day after, in India (IST). Fares are quoted for those three days only. Defaults to today when left out. With train_type T (MMTS), today only.
classquerystringOptionalII for Second Class or FC for First Class.
train_typequerystringOptionalO Ordinary, E Mail/Express, S Superfast, or T MMTS. MMTS fares are quoted for today only.
ticket_typequerystringOptionalJ Journey, M Monthly, Q Quarterly, H Half Yearly, or Y Yearly.
adultqueryintegerOptionalAdult passenger count.
childqueryintegerOptionalChild passenger count.
concessionquerystringOptionalApplicable UTS concession code.

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

RUN_DATE=$(TZ=Asia/Kolkata date +%F)

curl -sS -X GET \
  -H "X-RailCore-Key: $RAILCORE_KEY" \
  "https://ir.railcore.tech/v1/fares/unreserved?from=AN&to=BSL&date=$RUN_DATE&class=II&train_type=O&ticket_type=J&adult=1&child=0"

JavaScript

const runDate = new Intl.DateTimeFormat("en-CA", { timeZone: "Asia/Kolkata" }).format(new Date());

const response = await fetch(`https://ir.railcore.tech/v1/fares/unreserved?from=AN&to=BSL&date=${runDate}&class=II&train_type=O&ticket_type=J&adult=1&child=0`, {
  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

run_date = datetime.datetime.now(datetime.timezone(datetime.timedelta(hours=5, minutes=30))).date().isoformat()

response = requests.request(
    "GET",
    f"https://ir.railcore.tech/v1/fares/unreserved?from=AN&to=BSL&date={run_date}&class=II&train_type=O&ticket_type=J&adult=1&child=0",
    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
from_station_code / to_station_codestringThe two stations of the fare.
from / to (deprecated)stringDeprecated: the same codes as from_station_code and to_station_code. Still sent, and removed in a later release; read from_station_code and to_station_code instead.
datestring(date)The date the fare is quoted for.
class / train_type / ticket_typestringApplied fare categories.
adult / childintegerPassenger counts.
routes[].routestringRoute including any via stations.
routes[].farenumberFare in rupees, for example 15 or 17.5.

Example response

{
  "success": true,
  "data": {
    "from_station_code": "AN",
    "to_station_code": "BSL",
    "from": "AN",
    "to": "BSL",
    "date": "2026-11-20",
    "class": "II",
    "train_type": "O",
    "ticket_type": "J",
    "adult": 1,
    "child": 0,
    "routes": [
      {
        "route": "AN-JL-BSL",
        "fare": 20
      }
    ]
  },
  "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
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 Fares endpoints

All RailCore Indian Railways API endpoints · Quickstart · Rate limits

Last updated