RailRadarRailRadarDocs

Station Live Board

GET/v1/stations/{code}/live

Station live board

Description

Live arrival/departure board — similar to platform displays. **Time window:** `[now − 4h, now + hoursAhead]` Each train entry includes a `live` object with status: `at-station`, `upcoming`, `departed`, or `scheduled`.

Parameters

NameInTypeRequiredDescription
codepathstringYesStation code (1–10 uppercase characters)
hoursquery2 | 4 | 6 | 8NoHours ahead to look for trains. Allowed: `2`, `4`, `6`, `8`. Default: `4` Default: 4
includeIntermediatequerytrue | falseNoInclude pass-through (non-halting) trains in the live board. Default: `false` Default: false

Code Examples

CURL
curl -X GET "https://api.railradar.in/v1/stations/INDB/live?hours=4" \
  -H "Authorization: Bearer rr_live_YOUR_API_KEY"

Example Response

JSON200 OK
{
  "success": true,
  "data": {
    "station": {
      "code": "INDB",
      "name": "Indore Junction"
    },
    "window": {
      "from": "07:54",
      "to": "15:54",
      "hoursBack": 4,
      "hoursAhead": 4
    },
    "count": 1,
    "trains": [
      {
        "train": {
          "number": "12919",
          "name": "Malwa SF Express",
          "type": "Superfast Express",
          "source": "INDB",
          "destination": "SVDK",
          "runDays": [
            "mon",
            "tue",
            "wed",
            "thu",
            "fri",
            "sat",
            "sun"
          ]
        },
        "stop": {
          "sequence": 1,
          "arrival": null,
          "departure": "23:55",
          "day": 1,
          "distance": 0
        },
        "live": {
          "type": "at-station",
          "expectedDepartureTime": "2026-06-22T23:55:00+05:30",
          "platform": "4",
          "delayMinutes": 0
        }
      }
    ]
  },
  "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"
  }
}