Get Train Details

GET/v1/trains/{number}

Get train details

Description

Returns static train info with full schedule. Use `haltsOnly=true` to skip pass-through stops.

Parameters

Name	In	Type	Required	Description
`number`	path	`string`	Yes	5-digit train number
`haltsOnly`	query	`true \| false`	No	Return only halting stops (excludes pass-through). Default: `false` Default: `false`

Code Examples

CURL

curl -X GET "https://api.railradar.in/v1/trains/12919?haltsOnly=true" \
  -H "Authorization: Bearer rr_live_YOUR_API_KEY"

Example Response

JSON200 OK

{
  "success": true,
  "data": {
    "train": {
      "number": "12919",
      "name": "Malwa SF Express",
      "type": "Superfast Express",
      "category": "Superfast",
      "source": {
        "code": "INDB",
        "name": "Indore Junction"
      },
      "destination": {
        "code": "SVDK",
        "name": "Shri Mata Vaishno Devi Katra"
      },
      "runDays": [
        "mon",
        "tue",
        "wed",
        "thu",
        "fri",
        "sat",
        "sun"
      ],
      "distance": 1640,
      "duration": 1720,
      "avgSpeed": 57.2,
      "maxSpeed": 110,
      "totalHalts": 45,
      "returnTrain": "12920",
      "coachPosition": "Engine-H1-A1-A2-B1-B2-B3-B4-PC-S1-S2-S3-S4-S5-S6-S7-S8-S9-S10-S11-S12-DL1"
    },
    "route": [
      {
        "sequence": 1,
        "station": {
          "code": "INDB",
          "name": "Indore Junction"
        },
        "arrival": null,
        "departure": "23:55",
        "arrivalDay": 1,
        "departureDay": 1,
        "distance": 0,
        "isHalt": true,
        "platform": "4",
        "speedToNextStationKmph": 55
      },
      {
        "sequence": 2,
        "station": {
          "code": "UJN",
          "name": "Ujjain Junction"
        },
        "arrival": "00:55",
        "departure": "01:00",
        "arrivalDay": 2,
        "departureDay": 2,
        "distance": 55,
        "isHalt": true,
        "platform": "1",
        "speedToNextStationKmph": 60
      }
    ]
  },
  "meta": {
    "traceId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-06-22T12:30:00+05:30",
    "executionTime": 38,
    "source": "database"
  }
}

Try it Out

Error Codes

Status	Meaning
`400`	Bad Request — invalid or missing parameter
`401`	Unauthorized — missing or invalid Authorization Bearer token
`404`	Not Found — train/station not found (or no results)
`429`	Too Many Requests — rate limit exceeded
`503`	Service 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"
  }
}

Description#

Parameters#

Code Examples#

Example Response#

Try it Out#