Search stations

Find stations by code, city, name, or alias.

GET /v1/stations/search

Scope stations:read · Credits 1 · Plans All plans

Searches the RailCore reference index and returns ranked canonical station records suitable for autocomplete and station resolution.

Authentication

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

Request parameters

Name	In	Type	Required	Description
`q`	query	`string`	Required	Search text, station code, city, or alias. 1 to 80 characters.
`limit`	query	`integer`	Optional	Maximum results.

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/stations/search?q=bhusaval&limit=5"

JavaScript

const response = await fetch("https://ir.railcore.tech/v1/stations/search?q=bhusaval&limit=5", {
  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/stations/search?q=bhusaval&limit=5",
    headers={"X-RailCore-Key": os.environ["RAILCORE_KEY"]},
    timeout=20,
)
print(response.status_code, response.json())

Rate limits and credits

This call costs 1 credit 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

Field	Type	Description
`query`	`string`	Normalized query.
`limit`	`integer`	Applied result limit.
`results[]`	`Station[]`	Ranked station records.
`results[].station_code`	`string`	Canonical station code.
`results[].station_name`	`string`	Canonical station name.
`results[].display_name`	`string`	Name formatted for user interfaces.
`results[].city`	`string \| null`	Associated city when available.
`results[].state`	`string \| null`	Indian state or union territory when available.
`results[].country`	`string`	ISO country code, normally IN.
`results[].latitude`	`number \| null`	WGS84 latitude.
`results[].longitude`	`number \| null`	WGS84 longitude.
`results[].aliases`	`string[]`	Known alternate names and codes.
`results[].is_major`	`boolean`	Whether the station is considered a major junction or hub.
`results[].confidence`	`number`	Match confidence from 0 to 1.

Example response

{
  "success": true,
  "data": {
    "query": "bhusaval",
    "limit": 5,
    "results": [
      {
        "station_code": "BSL",
        "station_name": "Bhusaval Jn",
        "display_name": "Bhusaval Jn",
        "city": "Bhusawal",
        "state": "Maharashtra",
        "country": "IN",
        "latitude": 21.048194,
        "longitude": 75.788607,
        "aliases": [
          "Bhusaval Junction"
        ],
        "is_major": true,
        "confidence": 0.98
      }
    ]
  },
  "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

Status	Code	Description	Retry
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

Related Stations endpoints

All RailCore Indian Railways API endpoints · Quickstart · Rate limits