Nearby Stops

Find stops near a location. Returns bus stops by default — pass modes=all to include train stations, light rail, and ferry wharves. Ghost stops (decommissioned stops that return zero departures) are automatically filtered out.

GET/v1/nearby

Parameters

Parameter	Type	Required	Description
lat	float	Required	Latitude (e.g. -33.8688)
lng	float	Required	Longitude (e.g. 151.2093)
radius	integer	Optional	Radius in metres. Default: 500, Max: 2000
limit	integer	Optional	Max stops to return. Default: 10
modes	string	Optional	Transport mode filter: "all" or a comma-separated list of train, metro, lightrail, bus, coach, ferry, schoolbus. Default: bus.

Example

cURL

curl "https://api.transitkit.dev/v1/nearby?lat=-33.8688&lng=151.2093&radius=500" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

200 OK

{
  "location": { "lat": -33.8688, "lng": 151.2093 },
  "stops": [
    {
      "stop_id": "200060",
      "name": "Circular Quay, Stand A",
      "distance_metres": 120,
      "lat": -33.861711,
      "lng": 151.210787,
      "modes": ["bus"],
      "routes": []
    },
    {
      "stop_id": "200061",
      "name": "Circular Quay, Stand B",
      "distance_metres": 180,
      "lat": -33.861926,
      "lng": 151.211193,
      "modes": ["bus", "ferry"],
      "routes": []
    }
  ]
}

Response Fields

Field	Type	Description
stop_id	string	TfNSW stop identifier
name	string	Human-readable stop name
distance_metres	integer	Distance from queried location in metres
lat	float \| null	Latitude (EPSG:4326), null if unavailable
lng	float \| null	Longitude (EPSG:4326), null if unavailable
modes	string[]	Transport modes serving this stop (e.g. ["train", "bus"])
routes	string[]	Reserved — currently always an empty array

Note on coordinates: The raw TfNSW API accepts longitude:latitude order in query parameters but returns [latitude, longitude] in responses. TransitKit uses standard lat, lng order everywhere.

Coverage note: TfNSW data includes ACT bus stops, so TransitKit works for Canberra-based applications too. Stops in the ACT will appear in nearby results when querying Canberra coordinates.