Skip to main content
GET /api/route/{callsign} Looks up the origin and destination airports for an active flight using the adsb.lol routeset API. Returns coordinates and names for both endpoints, suitable for drawing a great-circle arc on the map.
Rate limit: 60 requests per minute per IP.

​
Path parameters

​
callsign
string
required
ICAO flight callsign (e.g. BAW123, UAL456). Case-insensitive.

​
Query parameters

​
lat
number
default:"0.0"
Current latitude of the aircraft. Used by adsb.lol for nearest-airport resolution when the callsign matches multiple routes. Optional.
​
lng
number
default:"0.0"
Current longitude of the aircraft. Optional.

​
Response

Returns an object with route details when a route is found, or an empty object {} when no route is available for the callsign.
​
orig_loc
number[]
Origin airport coordinates as [longitude, latitude] (GeoJSON order).
​
dest_loc
number[]
Destination airport coordinates as [longitude, latitude].
​
origin_name
string
Origin airport label in "IATA: Name" or "ICAO: Name" format (e.g. "LHR: London Heathrow").
​
dest_name
string
Destination airport label in the same format.
Returns an empty object {} when adsb.lol has no route data for the callsign. This is common for military, charter, or unscheduled flights.

​
Example

curl "http://localhost:8000/api/route/BAW123?lat=51.47&lng=-0.46"

{
  "orig_loc": [-0.4543, 51.4775],
  "dest_loc": [-73.7789, 40.6398],
  "origin_name": "LHR: London Heathrow",
  "dest_name": "JFK: John F Kennedy Intl"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us