Shipping: Find Trains (Legacy)

GET/v1/legacy/modules/shipping/find-trains

Shipping Module: Find Trains (Legacy)

Description

Finds trains for shipping between a source station and a target geographic radius.

Parameters

Name	In	Type	Required	Description
`source`	query	`string`	Yes	Source station code
`lat`	query	`number`	Yes	Target latitude
`lng`	query	`number`	Yes	Target longitude
`radius`	query	`number`	No	Radius in km (default 100) Default: `100`
`minHaltSource`	query	`integer`	No	Minimum halt minutes at source station (default 2) Default: `2`
`minHaltNear`	query	`integer`	No	Minimum halt minutes at target station (default 2) Default: `2`
`limit`	query	`integer`	No	Maximum number of results to return (default 50) Default: `50`

Code Examples

CURL

curl -X GET "https://api.railradar.in/v1/legacy/modules/shipping/find-trains?source=NDLS&lat=27.795&lng=77.433" \
  -H "Authorization: Bearer rr_live_YOUR_API_KEY"

Example Response

JSON200 OK

{
  "success": true,
  "data": [
    {
      "stationCode": "KSV",
      "stationName": "Kosi Kalan",
      "lat": 27.795105,
      "lng": 77.433853,
      "distanceKm": 88.58,
      "totalTrains": 1,
      "trains": [
        {
          "trainNumber": "11906",
          "trainName": "Agra Cantt Express",
          "type": "Mail/Express",
          "runningDays": {
            "mon": true,
            "tue": true,
            "wed": true,
            "thu": true,
            "fri": true,
            "sat": true,
            "sun": true
          },
          "loading": {
            "stationCode": "NDLS",
            "stationName": "New Delhi",
            "arrival": "07:10",
            "departure": "07:20",
            "haltMinutes": 10,
            "day": 2
          },
          "unloading": {
            "stationCode": "KSV",
            "stationName": "Kosi Kalan",
            "arrival": "08:50",
            "departure": "08:52",
            "haltMinutes": 2,
            "day": 2
          }
        }
      ]
    }
  ],
  "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#