GET

/trains

Search trains by name or number. Results are ordered by relevance.

Request

curl "https://api.traindekho.live/v1/trains?q=rajdhani&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

Name	In	Required	Description
q	query	yes	Train number, train name, station code, or station name.
limit	query	no	Maximum results, from 1 to 25. Defaults to 10.

Responses

200

Matching trains, highest relevance first.

{
  "trains": [
    {
      "train_no": "12951",
      "name": "Mumbai Rajdhani",
      "type": "RAJ",
      "origin": {
        "code": "MMCT",
        "name": "Mumbai Central"
      },
      "destination": {
        "code": "NDLS",
        "name": "New Delhi"
      }
    }
  ]
}

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."
  }
}

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."
  }
}