Find trains serving a route on a date.
GET /v1/routes/trains
Scope journeys:read · Credits 5 · Plans All plans
Returns route-matching trains with schedule, classes, running pattern, and compact availability context.
Send your key in the X-RailCore-Key header. This operation requires the journeys:read scope. See the authentication guide.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
from | query | string | Required | Boarding station code. |
to | query | string | Required | Destination station code. |
date | query | string(date) | Required | Journey date in YYYY-MM-DD format. |
quota | query | string | Optional | Reservation quota. |
Base URL https://ir.railcore.tech/v1. Keep the key in an environment variable and call from a trusted server-side environment.
curl -sS -X GET \
-H "X-RailCore-Key: $RAILCORE_KEY" \
"https://ir.railcore.tech/v1/routes/trains?from=BSL&to=ADI&date=2026-08-27"a=GN"
const response = await fetch("https://ir.railcore.tech/v1/routes/trains?from=BSL&to=ADI&date=2026-08-27"a=GN", {
method: "GET",
headers: {
"X-RailCore-Key": process.env.RAILCORE_KEY,
},
});
const body = await response.json();
console.log(response.status, body);
import os
import requests
response = requests.request(
"GET",
"https://ir.railcore.tech/v1/routes/trains?from=BSL&to=ADI&date=2026-08-27"a=GN",
headers={"X-RailCore-Key": os.environ["RAILCORE_KEY"]},
timeout=20,
)
print(response.status_code, response.json())
This call costs 5 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.
| Field | Type | Description |
|---|---|---|
from_station_code | string | Resolved origin. |
to_station_code | string | Resolved destination. |
journey_date | string(date) | Requested journey date. |
quota | Quota | Applied reservation quota. |
trains[].train_number | string | Train number. |
trains[].train_name | string | Train name. |
trains[].departure_time / arrival_time | string | Scheduled segment times in HH:mm. |
trains[].duration_minutes | integer | Segment duration. |
trains[].distance_km | number | null | Segment distance. |
trains[].train_type | string | Normalized train type. |
trains[].classes | ClassCode[] | Offered travel classes. |
trains[].running_days | RunningDay[] | Weekly running pattern. |
trains[].has_pantry | boolean | null | Pantry availability when known. |
trains[].on_time_rating | number | null | Historical punctuality rating when available. |
trains[].availability_summary | AvailabilityMini[] | Compact class-level status, fare, confidence, and update time. |
{
"success": true,
"data": {
"from_station_code": "BSL",
"to_station_code": "ADI",
"journey_date": "2026-08-27",
"quota": "GN",
"trains": [
{
"train_number": "12656",
"train_name": "Navjeevan SF Express",
"departure_time": "10:25",
"arrival_time": "18:00",
"duration_minutes": 455,
"classes": [
"SL",
"3A",
"2A",
"1A"
],
"running_days": [
"MON",
"TUE",
"WED",
"THU",
"FRI",
"SAT",
"SUN"
]
}
]
},
"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"
}
]
}
}
}
| Status | Code | Description | Retry |
|---|---|---|---|
| 404 | NO_TRAINS_FOUND | No train matches the route and date. | Not retryable |
| 400 | VALIDATION_ERROR | A required field is missing or invalid. | Not retryable |
| 401 | MISSING_API_KEY / INVALID_API_KEY | The credential is absent, unknown, disabled, or expired. | Not retryable |
| 403 | SCOPE_MISSING / PLAN_ENDPOINT_DISABLED | The key lacks the required scope or plan entitlement. | Not retryable |
| 402 | CREDITS_EXHAUSTED | The account balance cannot cover this operation. | Not retryable |
| 429 | RATE_LIMITED | Minute or daily request budget is exhausted. 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 |
| 502 | UPSTREAM_UNAVAILABLE | Live data could not be retrieved. Retry with backoff. | Retryable |
| 504 | UPSTREAM_TIMEOUT | The live-data request exceeded its deadline. Retry with backoff. | Retryable |
| 503 | METERING_UNAVAILABLE | Credit settlement is temporarily unavailable and no data was returned. | Retryable |
All RailCore Indian Railways API endpoints · Quickstart · Rate limits