RailRadarRailRadarDocs

Train Lookup

GET/v1/lookup/trains

All train numbers → names (ACTIVE only)

Description

Returns a flat `{ number: name }` map for every **active** train. Cancelled/inactive trains are excluded. Response is cached.

Code Examples

CURL
curl -X GET "https://api.railradar.in/v1/lookup/trains" \
  -H "Authorization: Bearer rr_live_YOUR_API_KEY"

Example Response

JSON200 OK
{
  "success": true,
  "data": {
    "12002": "New Delhi - Bhopal Shatabdi Express",
    "12919": "Malwa Express",
    "12920": "Malwa Express (Return)"
  },
  "meta": {
    "traceId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-06-22T12:30:00+05:30",
    "executionTime": 38,
    "source": "database"
  }
}

Try it Out

Login to test this endpoint

Sign in to pre-fill your API key and send live requests directly from the browser.

Sign in →

Error Codes

StatusMeaning
400Bad Request — invalid or missing parameter
401Unauthorized — missing or invalid Authorization Bearer token
404Not Found — train/station not found (or no results)
429Too Many Requests — rate limit exceeded
503Service Unavailable — upstream data source temporarily down

Error Response Examples

JSON Error Envelope404 Not Found
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found (e.g. Train 12919 not found on journey date 2026-06-22)"
  },
  "meta": {
    "traceId": "9772f1c9-6ec6-4d9f-b269-a5210f33ec73",
    "timestamp": "2026-06-22T08:14:00+05:30",
    "executionTime": 5,
    "source": "database"
  }
}