GET

/trains/{train_no}/schedule

Returns the scheduled stops for one train, including intermediate stations.

Request

curl "https://api.traindekho.live/v1/trains/12951/schedule" \
  -H "X-API-Key: YOUR_API_KEY"

Name	In	Required	Description
train_no	path	yes	Train number, four or five digits.

Responses

200

Scheduled stops, including intermediate stations.

{
  "train": {
    "train_no": "12951",
    "name": "Mumbai Rajdhani",
    "type": "RAJ",
    "origin": {
      "code": "MMCT",
      "name": "Mumbai Central"
    },
    "destination": {
      "code": "NDLS",
      "name": "New Delhi"
    },
    "days_of_run": {
      "sun": false,
      "mon": true,
      "tue": true,
      "wed": true,
      "thu": true,
      "fri": true,
      "sat": true
    },
    "classes": [
      "1A",
      "2A",
      "3A"
    ],
    "duration_minutes": 980,
    "distance_km": 1384,
    "stop_count": 8
  },
  "stops": [
    {
      "sequence": 1,
      "station": {
        "code": "MMCT",
        "name": "Mumbai Central"
      },
      "arrival_time": null,
      "departure_time": "17:05",
      "day_offset": 0,
      "distance_km": 0,
      "platform": "1",
      "halt_minutes": 0,
      "lat": 18.969,
      "lon": 72.819,
      "intermediate_stations": []
    }
  ]
}

400

A path or query value is missing or has the wrong format.

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Request is invalid."
  }
}

401

The API key is missing, unknown, expired, or revoked.

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication is required."
  }
}

403

The credential is valid and does not include this API.

{
  "error": {
    "code": "FORBIDDEN",
    "message": "You do not have access to this API."
  }
}

404

The train or station does not exist.

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Not found."
  }
}

429

The caller exceeded a rate limit or a quota. Wait for Retry-After seconds before retrying.

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "API request limit exceeded"
  }
}

500

The request could not be completed.

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "The request could not be completed."
  }
}