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.
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.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
from | query | string | Required | Boarding station code. |
to | query | string | Required | Destination station code. |
date | query | string(date) | Optional | Journey 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. |
class | query | string | Optional | II for Second Class or FC for First Class. |
train_type | query | string | Optional | O Ordinary, E Mail/Express, S Superfast, or T MMTS. MMTS fares are quoted for today only. |
ticket_type | query | string | Optional | J Journey, M Monthly, Q Quarterly, H Half Yearly, or Y Yearly. |
adult | query | integer | Optional | Adult passenger count. |
child | query | integer | Optional | Child passenger count. |
concession | query | string | Optional | Applicable UTS concession code. |
Base URL https://ir.railcore.tech/v1. Keep the key in an environment variable and call from a trusted server-side environment.
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"
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);
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())
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.
| Field | Type | Description |
|---|---|---|
from_station_code / to_station_code | string | The two stations of the fare. |
from / to (deprecated) | string | Deprecated: 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. |
date | string(date) | The date the fare is quoted for. |
class / train_type / ticket_type | string | Applied fare categories. |
adult / child | integer | Passenger counts. |
routes[].route | string | Route including any via stations. |
routes[].fare | number | Fare in rupees, for example 15 or 17.5. |
{
"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"
}
]
}
}
}
| Status | Code | Description | Retry |
|---|---|---|---|
| 400 | VALIDATION_ERROR | A required field is missing or invalid. error.details[].field names the parameter, such as date or items[2].date. | Not retryable |
| 401 | MISSING_API_KEY | No key in X-RailCore-Key, Authorization: Bearer or X-Api-Key, or the key is too short. | Not retryable |
| 401 | INVALID_API_KEY | The key is unknown or revoked. A disabled or expired key answers API_KEY_DISABLED or API_KEY_EXPIRED. | Not retryable |
| 401 | AMBIGUOUS_API_KEY | More than one key header was sent, with different keys. Send the key in one header. | Not retryable |
| 401 | SIGNATURE_INVALID | HMAC 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 |
| 403 | SCOPE_MISSING | The key lacks this operation's scope. | Not retryable |
| 403 | PLAN_ENDPOINT_DISABLED | The account's plan does not include this endpoint. | Not retryable |
| 402 | CREDITS_EXHAUSTED | The month's requests are used up, or too few are left for this request. Nothing is fetched. | Not retryable |
| 429 | RATE_LIMITED | The 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 |
| 410 | API_VERSION_SUNSET | This API version has reached its announced sunset date. Migrate to a supported major version. | Not retryable |
| 503 | UPSTREAM_UNAVAILABLE | Live data could not be retrieved. Wait for Retry-After, then retry with backoff. Not counted. | Retryable |
| 503 | UPSTREAM_TIMEOUT | The live-data request ran past its deadline. Wait for Retry-After, then retry with backoff. Not counted. | Retryable |
| 503 | METERING_UNAVAILABLE | The request could not be counted, so no data was returned. Retry with backoff. | Retryable |
All RailCore Indian Railways API endpoints · Quickstart · Rate limits
Last updated