# adsb.lol

> Track aircraft live with adsb.lol, an open flight tracker run by a community of ADS-B receivers. Find what is flying over a place, look up an aircraft by hex code, callsign or registration, find every aircraft of a type or squawking an emergency code, list military aircraft, and get a flight's route and airports. No account or API key required.

App · 13 actions. Web page: https://docs.lodol.com/docs/integrations/adsb-lol

## Actions

### Find aircraft by squawk code

Find every aircraft squawking a transponder code right now, worldwide. Use 7700 to find aircraft declaring an emergency, 7600 for radio failure or 7500 for a hijack. Often none: that comes back as an empty list, not a failure. No API key required.

**Inputs**

- Squawk code (`squawk`, text, required): The four-digit transponder code, each digit from 0 to 7, such as 7700.
- Flight status (`flight_status`, text): Keep every aircraft, only those in the air, or only those on the ground. Near an airport, 'Only airborne' leaves out parked aircraft and airport vehicles. One of: `any` (Any aircraft), `airborne` (Only airborne), `on_ground` (Only on the ground). Default: `any`.
- How many to return (`limit`, number): The most aircraft to return, from 1 to 1000. The result also says how many match altogether. From 1 to 1000. Default: `250`.

**Outputs**

- `aircraft` (list): The aircraft found, each with its position, altitude and speed.
- `as_of` (text): When adsb.lol's live picture was taken, in UTC (ISO 8601).
- `count` (number): How many aircraft came back.
- `flight_status` (text): Which aircraft were kept: any, airborne or on_ground.
- `more_available` (true/false): Whether raising the limit would return more aircraft.
- `squawk` (text): The squawk code searched for.
- `total` (number): How many aircraft match altogether. More than the count when the limit cut the list short.

**Example output**

```json
{
  "aircraft": [
    {
      "altitude_baro_ft": 14000,
      "altitude_geom_ft": 14375,
      "bearing_deg": null,
      "callsign": "RYR7JZ",
      "category": "A3",
      "category_description": "Large (75,000 to 300,000 lb)",
      "distance_nm": null,
      "emergency": "general",
      "emergency_description": "General emergency",
      "ground_speed_kt": 312.0,
      "hex": "4ca87c",
      "ladd": false,
      "latitude": 50.912,
      "longitude": 4.484,
      "map_url": "https://globe.adsb.lol/?icao=4ca87c",
      "military": false,
      "on_ground": false,
      "pia": false,
      "position_seconds_ago": 0.3,
      "registration": "EI-EBA",
      "seen_seconds_ago": 0.1,
      "source": "ADS-B",
      "squawk": "7700",
      "track_deg": 102.3,
      "type_code": "B738",
      "vertical_rate_fpm": -2304
    }
  ],
  "as_of": "2026-10-22T04:04:03Z",
  "count": 1,
  "flight_status": "any",
  "more_available": false,
  "squawk": "7700",
  "total": 1
}
```

### Find aircraft by type

Find every aircraft of a type that adsb.lol is tracking worldwide right now, such as every Airbus A380 in the air, with their positions, altitudes and callsigns. No API key required.

**Inputs**

- Aircraft type (`type_codes`, text, required): The ICAO type designator, 2 to 4 letters and digits, such as A388 for an Airbus A380 or B738 for a Boeing 737-800. Several can be given separated by commas, up to 20.
- Flight status (`flight_status`, text): Keep every aircraft, only those in the air, or only those on the ground. Near an airport, 'Only airborne' leaves out parked aircraft and airport vehicles. One of: `any` (Any aircraft), `airborne` (Only airborne), `on_ground` (Only on the ground). Default: `any`.
- How many to return (`limit`, number): The most aircraft to return, from 1 to 1000. The result also says how many match altogether. From 1 to 1000. Default: `250`.

**Outputs**

- `aircraft` (list): The aircraft found, each with its position, altitude and speed.
- `as_of` (text): When adsb.lol's live picture was taken, in UTC (ISO 8601).
- `count` (number): How many aircraft came back.
- `flight_status` (text): Which aircraft were kept: any, airborne or on_ground.
- `more_available` (true/false): Whether raising the limit would return more aircraft.
- `total` (number): How many aircraft match altogether. More than the count when the limit cut the list short.
- `type_codes` (list): The type designators searched for, in upper case.

**Example output**

```json
{
  "aircraft": [
    {
      "altitude_baro_ft": 9000,
      "altitude_geom_ft": 9450,
      "bearing_deg": null,
      "callsign": "BAW16",
      "category": "A5",
      "category_description": "Heavy (over 300,000 lb)",
      "distance_nm": null,
      "emergency": null,
      "emergency_description": null,
      "ground_speed_kt": 286.4,
      "hex": "406f72",
      "ladd": false,
      "latitude": 51.465363,
      "longitude": 0.051146,
      "map_url": "https://globe.adsb.lol/?icao=406f72",
      "military": false,
      "on_ground": false,
      "pia": false,
      "position_seconds_ago": 0.4,
      "registration": "G-ZBKF",
      "seen_seconds_ago": 0.2,
      "source": "ADS-B",
      "squawk": "4432",
      "track_deg": 268.9,
      "type_code": "B789",
      "vertical_rate_fpm": -1088
    }
  ],
  "as_of": "2026-10-22T04:04:03Z",
  "count": 1,
  "flight_status": "airborne",
  "more_available": true,
  "total": 431,
  "type_codes": [
    "B789"
  ]
}
```

### Find aircraft in an area

Find every aircraft adsb.lol is tracking within a radius of a point, closest first: callsign, registration, type, position, altitude, speed, heading, squawk and how far away it is. Up to 250 nautical miles. No API key required.

**Inputs**

- Latitude (`latitude`, number, required): Latitude of the centre point, in degrees from -90 to 90 (north is positive). London Heathrow is 51.47. From -90 to 90.
- Longitude (`longitude`, number, required): Longitude of the centre point, in degrees from -180 to 180 (east is positive). London Heathrow is -0.4543. From -180 to 180.
- Radius (nautical miles) (`radius_nm`, number): How far from the centre to look, in nautical miles, from 1 to 250 (adsb.lol's maximum). One nautical mile is 1.852 km. From 1 to 250. Default: `25`.
- Flight status (`flight_status`, text): Keep every aircraft, only those in the air, or only those on the ground. Near an airport, 'Only airborne' leaves out parked aircraft and airport vehicles. One of: `any` (Any aircraft), `airborne` (Only airborne), `on_ground` (Only on the ground). Default: `any`.
- How many to return (`limit`, number): The most aircraft to return, from 1 to 1000. The result also says how many match altogether. From 1 to 1000. Default: `250`.

**Outputs**

- `aircraft` (list): The aircraft in the area, closest to the centre first, each with its distance and bearing from it.
- `as_of` (text): When adsb.lol's live picture was taken, in UTC (ISO 8601).
- `count` (number): How many aircraft came back.
- `flight_status` (text): Which aircraft were kept: any, airborne or on_ground.
- `latitude` (number): The latitude of the centre searched.
- `longitude` (number): The longitude of the centre searched.
- `more_available` (true/false): Whether raising the limit would return more aircraft.
- `radius_nm` (number): The radius searched, in nautical miles.
- `total` (number): How many aircraft match altogether. More than the count when the limit cut the list short.

**Example output**

```json
{
  "aircraft": [
    {
      "altitude_baro_ft": null,
      "altitude_geom_ft": null,
      "bearing_deg": 276.6,
      "callsign": "GNEOP",
      "category": "A3",
      "category_description": "Large (75,000 to 300,000 lb)",
      "distance_nm": 1.2,
      "emergency": null,
      "emergency_description": null,
      "ground_speed_kt": 0.0,
      "hex": "407600",
      "ladd": false,
      "latitude": 51.472262,
      "longitude": -0.485973,
      "map_url": "https://globe.adsb.lol/?icao=407600",
      "military": false,
      "on_ground": true,
      "pia": false,
      "position_seconds_ago": 2.5,
      "registration": "G-NEOP",
      "seen_seconds_ago": 1.5,
      "source": "ADS-B",
      "squawk": "2000",
      "track_deg": null,
      "type_code": "A21N",
      "vertical_rate_fpm": null
    },
    {
      "altitude_baro_ft": 9000,
      "altitude_geom_ft": 9450,
      "bearing_deg": 88.4,
      "callsign": "BAW16",
      "category": "A5",
      "category_description": "Heavy (over 300,000 lb)",
      "distance_nm": 15.9,
      "emergency": null,
      "emergency_description": null,
      "ground_speed_kt": 286.4,
      "hex": "406f72",
      "ladd": false,
      "latitude": 51.465363,
      "longitude": 0.051146,
      "map_url": "https://globe.adsb.lol/?icao=406f72",
      "military": false,
      "on_ground": false,
      "pia": false,
      "position_seconds_ago": 0.4,
      "registration": "G-ZBKF",
      "seen_seconds_ago": 0.2,
      "source": "ADS-B",
      "squawk": "4432",
      "track_deg": 268.9,
      "type_code": "B789",
      "vertical_rate_fpm": -1088
    }
  ],
  "as_of": "2026-10-22T04:04:03Z",
  "count": 2,
  "flight_status": "any",
  "latitude": 51.47,
  "longitude": -0.4543,
  "more_available": false,
  "radius_nm": 25,
  "total": 2
}
```

### Get airport

Look up an airport by its four-letter ICAO code: its name, IATA code, city, country, position and elevation. No API key required.

**Inputs**

- Airport (`airport_code`, text, required): The airport's four-letter ICAO code, such as EGLL for London Heathrow, in any case. A three-letter IATA code (LHR) is not accepted.

**Outputs**

- `city` (text): The city or place it serves.
- `country_code` (text): Its country as a two-letter ISO code, such as 'GB'.
- `elevation_ft` (number): Its elevation above sea level, in feet.
- `elevation_m` (number): Its elevation above sea level, in metres.
- `iata` (text): Its three-letter IATA code, such as 'LHR'.
- `icao` (text): The airport's four-letter ICAO code, such as 'EGLL'.
- `latitude` (number): Its latitude in degrees.
- `longitude` (number): Its longitude in degrees.
- `name` (text): Its name, such as 'London Heathrow Airport'.

**Example output**

```json
{
  "city": "London",
  "country_code": "GB",
  "elevation_ft": 83.0,
  "elevation_m": 25.3,
  "iata": "LHR",
  "icao": "EGLL",
  "latitude": 51.4706,
  "longitude": -0.461941,
  "name": "London Heathrow Airport"
}
```

### Get flight route

Get the route on file for a flight's callsign: where it flies from and to, any stops, and each airport's name, codes and place. Give the aircraft's position too to check the route still fits the flight. A callsign with no route on file comes back with 'found' set to false rather than failing the step. No API key required.

**Inputs**

- Callsign (`callsign`, text, required): The flight's callsign as broadcast, such as BAW256 (the airline's ICAO code and flight number).
- Aircraft latitude (`latitude`, number): Where the aircraft is now, to check the route on file fits the flight: the latitude from an earlier aircraft lookup. Leave both empty to skip the check. From -90 to 90.
- Aircraft longitude (`longitude`, number): Where the aircraft is now: the longitude from the same lookup. Leave both empty to skip the check. From -180 to 180.

**Outputs**

- `airline_code` (text): The airline's ICAO code from the callsign, such as 'BAW'.
- `airports` (list): Every airport on the route, in order, stops included.
- `callsign` (text): The callsign looked up, in upper case.
- `destination` (object): The last airport on the route.
- `flight_number` (text): The flight number from the callsign, such as '16'.
- `found` (true/false): Whether a route is on file for this callsign. Private, military and unscheduled flights usually have none.
- `latitude` (number): The latitude the route was checked against, when one was given.
- `longitude` (number): The longitude the route was checked against, when one was given.
- `origin` (object): The first airport on the route.
- `position_fits_route` (true/false): Whether the aircraft position given lies along this route: within 50 nautical miles of the path between two airports on it, or a fifth of that leg's length when more. False usually means the route on file is out of date for this callsign. Empty when no position was given or no route is on file.
- `route` (text): The airports on the route as ICAO codes, in order, such as 'YSSY-WSSS-EGLL'.
- `route_iata` (text): The same route as IATA codes, such as 'SYD-SIN-LHR'.

**Example output**

```json
{
  "airline_code": "BAW",
  "airports": [
    {
      "city": "Sydney",
      "country_code": "AU",
      "elevation_ft": 21.0,
      "elevation_m": 6.4,
      "iata": "SYD",
      "icao": "YSSY",
      "latitude": -33.946098,
      "longitude": 151.177002,
      "name": "Sydney Kingsford Smith International Airport"
    },
    {
      "city": "Singapore",
      "country_code": "SG",
      "elevation_ft": 22.0,
      "elevation_m": 6.71,
      "iata": "SIN",
      "icao": "WSSS",
      "latitude": 1.35019,
      "longitude": 103.994003,
      "name": "Singapore Changi International Airport"
    },
    {
      "city": "London",
      "country_code": "GB",
      "elevation_ft": 83.0,
      "elevation_m": 25.3,
      "iata": "LHR",
      "icao": "EGLL",
      "latitude": 51.4706,
      "longitude": -0.461941,
      "name": "London Heathrow Airport"
    }
  ],
  "callsign": "BAW16",
  "destination": {
    "city": "London",
    "country_code": "GB",
    "elevation_ft": 83.0,
    "elevation_m": 25.3,
    "iata": "LHR",
    "icao": "EGLL",
    "latitude": 51.4706,
    "longitude": -0.461941,
    "name": "London Heathrow Airport"
  },
  "flight_number": "16",
  "found": true,
  "latitude": 51.465363,
  "longitude": 0.051146,
  "origin": {
    "city": "Sydney",
    "country_code": "AU",
    "elevation_ft": 21.0,
    "elevation_m": 6.4,
    "iata": "SYD",
    "icao": "YSSY",
    "latitude": -33.946098,
    "longitude": 151.177002,
    "name": "Sydney Kingsford Smith International Airport"
  },
  "position_fits_route": true,
  "route": "YSSY-WSSS-EGLL",
  "route_iata": "SYD-SIN-LHR"
}
```

### Get network stats

See how many aircraft the adsb.lol network is tracking around the world right now, and how many volunteer receivers are feeding it. No API key required.

**Inputs**: None.

**Outputs**

- `aircraft_tracked` (number): How many aircraft the adsb.lol network is tracking right now.
- `as_of` (text): When these totals were read, in UTC (ISO 8601).
- `mlat_receivers` (number): How many of them also take part in MLAT, which works out the position of aircraft that do not broadcast one.
- `receivers` (number): How many receivers are feeding it right now.

**Example output**

```json
{
  "aircraft_tracked": 5727,
  "as_of": "2026-10-22T04:04:03Z",
  "mlat_receivers": 5931,
  "receivers": 6329
}
```

### Get the closest aircraft

Get the one aircraft nearest a point, within a radius of up to 250 nautical miles, with its distance and bearing. Nothing in range comes back with 'found' set to false rather than failing the step. No API key required.

**Inputs**

- Latitude (`latitude`, number, required): Latitude of the centre point, in degrees from -90 to 90 (north is positive). London Heathrow is 51.47. From -90 to 90.
- Longitude (`longitude`, number, required): Longitude of the centre point, in degrees from -180 to 180 (east is positive). London Heathrow is -0.4543. From -180 to 180.
- Radius (nautical miles) (`radius_nm`, number): How far from the centre to look, in nautical miles, from 1 to 250 (adsb.lol's maximum). One nautical mile is 1.852 km. From 1 to 250. Default: `25`.
- Flight status (`flight_status`, text): Keep every aircraft, only those in the air, or only those on the ground. Near an airport, 'Only airborne' leaves out parked aircraft and airport vehicles. One of: `any` (Any aircraft), `airborne` (Only airborne), `on_ground` (Only on the ground). Default: `any`.

**Outputs**

- `aircraft` (object): The closest aircraft, with its distance and bearing from the point. Empty when none is within the radius.
- `as_of` (text): When adsb.lol's live picture was taken, in UTC (ISO 8601).
- `flight_status` (text): Which aircraft were kept: any, airborne or on_ground.
- `found` (true/false): Whether any aircraft was within the radius.
- `latitude` (number): The latitude of the centre searched.
- `longitude` (number): The longitude of the centre searched.
- `radius_nm` (number): The radius searched, in nautical miles.

**Example output**

```json
{
  "aircraft": {
    "altitude_baro_ft": null,
    "altitude_geom_ft": null,
    "bearing_deg": 276.6,
    "callsign": "GNEOP",
    "category": "A3",
    "category_description": "Large (75,000 to 300,000 lb)",
    "distance_nm": 1.2,
    "emergency": null,
    "emergency_description": null,
    "ground_speed_kt": 0.0,
    "hex": "407600",
    "ladd": false,
    "latitude": 51.472262,
    "longitude": -0.485973,
    "map_url": "https://globe.adsb.lol/?icao=407600",
    "military": false,
    "on_ground": true,
    "pia": false,
    "position_seconds_ago": 2.5,
    "registration": "G-NEOP",
    "seen_seconds_ago": 1.5,
    "source": "ADS-B",
    "squawk": "2000",
    "track_deg": null,
    "type_code": "A21N",
    "vertical_rate_fpm": null
  },
  "as_of": "2026-10-22T04:04:03Z",
  "flight_status": "any",
  "found": true,
  "latitude": 51.47,
  "longitude": -0.4543,
  "radius_nm": 25
}
```

### List LADD aircraft

List the aircraft on the FAA's LADD list (Limiting Aircraft Data Displayed) that adsb.lol is tracking right now: aircraft whose owners asked for them to be hidden from flight trackers, which adsb.lol still shows. No API key required.

**Inputs**

- Flight status (`flight_status`, text): Keep every aircraft, only those in the air, or only those on the ground. Near an airport, 'Only airborne' leaves out parked aircraft and airport vehicles. One of: `any` (Any aircraft), `airborne` (Only airborne), `on_ground` (Only on the ground). Default: `any`.
- How many to return (`limit`, number): The most aircraft to return, from 1 to 1000. The result also says how many match altogether. From 1 to 1000. Default: `250`.

**Outputs**

- `aircraft` (list): The aircraft found, each with its position, altitude and speed.
- `as_of` (text): When adsb.lol's live picture was taken, in UTC (ISO 8601).
- `count` (number): How many aircraft came back.
- `flight_status` (text): Which aircraft were kept: any, airborne or on_ground.
- `more_available` (true/false): Whether raising the limit would return more aircraft.
- `total` (number): How many aircraft match altogether. More than the count when the limit cut the list short.

**Example output**

```json
{
  "aircraft": [
    {
      "altitude_baro_ft": 12250,
      "altitude_geom_ft": 11650,
      "bearing_deg": null,
      "callsign": "OAE2544",
      "category": "A5",
      "category_description": "Heavy (over 300,000 lb)",
      "distance_nm": null,
      "emergency": null,
      "emergency_description": null,
      "ground_speed_kt": 349.8,
      "hex": "ab2ae1",
      "ladd": true,
      "latitude": 60.904944,
      "longitude": -149.306848,
      "map_url": "https://globe.adsb.lol/?icao=ab2ae1",
      "military": false,
      "on_ground": false,
      "pia": false,
      "position_seconds_ago": 0.22,
      "registration": "N819AX",
      "seen_seconds_ago": 0.2,
      "source": "ADS-B",
      "squawk": "1302",
      "track_deg": 295.03,
      "type_code": "B772",
      "vertical_rate_fpm": -1856
    }
  ],
  "as_of": "2026-10-22T04:04:03Z",
  "count": 1,
  "flight_status": "any",
  "more_available": true,
  "total": 149
}
```

### List military aircraft

List every aircraft adsb.lol's database marks as military that it is tracking worldwide right now, with positions, altitudes, types and callsigns. Military aircraft often fly without broadcasting a position, so some have none. No API key required.

**Inputs**

- Flight status (`flight_status`, text): Keep every aircraft, only those in the air, or only those on the ground. Near an airport, 'Only airborne' leaves out parked aircraft and airport vehicles. One of: `any` (Any aircraft), `airborne` (Only airborne), `on_ground` (Only on the ground). Default: `any`.
- How many to return (`limit`, number): The most aircraft to return, from 1 to 1000. The result also says how many match altogether. From 1 to 1000. Default: `250`.

**Outputs**

- `aircraft` (list): The aircraft found, each with its position, altitude and speed.
- `as_of` (text): When adsb.lol's live picture was taken, in UTC (ISO 8601).
- `count` (number): How many aircraft came back.
- `flight_status` (text): Which aircraft were kept: any, airborne or on_ground.
- `more_available` (true/false): Whether raising the limit would return more aircraft.
- `total` (number): How many aircraft match altogether. More than the count when the limit cut the list short.

**Example output**

```json
{
  "aircraft": [
    {
      "altitude_baro_ft": 3825,
      "altitude_geom_ft": 4050,
      "bearing_deg": null,
      "callsign": "C2011",
      "category": "A3",
      "category_description": "Large (75,000 to 300,000 lb)",
      "distance_nm": null,
      "emergency": null,
      "emergency_description": null,
      "ground_speed_kt": 172.0,
      "hex": "ae57d5",
      "ladd": false,
      "latitude": 21.203613,
      "longitude": -158.26416,
      "map_url": "https://globe.adsb.lol/?icao=ae57d5",
      "military": true,
      "on_ground": false,
      "pia": false,
      "position_seconds_ago": 0.467,
      "registration": "2011",
      "seen_seconds_ago": 0.5,
      "source": "ADS-B",
      "squawk": "2317",
      "track_deg": 269.67,
      "type_code": "C30J",
      "vertical_rate_fpm": 1920
    }
  ],
  "as_of": "2026-10-22T04:04:03Z",
  "count": 1,
  "flight_status": "any",
  "more_available": true,
  "total": 177
}
```

### List PIA aircraft

List the aircraft adsb.lol is tracking right now that fly an FAA privacy ICAO address (PIA): a temporary hex code that hides who owns the aircraft. Usually only a handful. No API key required.

**Inputs**

- Flight status (`flight_status`, text): Keep every aircraft, only those in the air, or only those on the ground. Near an airport, 'Only airborne' leaves out parked aircraft and airport vehicles. One of: `any` (Any aircraft), `airborne` (Only airborne), `on_ground` (Only on the ground). Default: `any`.
- How many to return (`limit`, number): The most aircraft to return, from 1 to 1000. The result also says how many match altogether. From 1 to 1000. Default: `250`.

**Outputs**

- `aircraft` (list): The aircraft found, each with its position, altitude and speed.
- `as_of` (text): When adsb.lol's live picture was taken, in UTC (ISO 8601).
- `count` (number): How many aircraft came back.
- `flight_status` (text): Which aircraft were kept: any, airborne or on_ground.
- `more_available` (true/false): Whether raising the limit would return more aircraft.
- `total` (number): How many aircraft match altogether. More than the count when the limit cut the list short.

**Example output**

```json
{
  "aircraft": [
    {
      "altitude_baro_ft": 18375,
      "altitude_geom_ft": null,
      "bearing_deg": null,
      "callsign": null,
      "category": null,
      "category_description": null,
      "distance_nm": null,
      "emergency": null,
      "emergency_description": null,
      "ground_speed_kt": null,
      "hex": "a03129",
      "ladd": false,
      "latitude": null,
      "longitude": null,
      "map_url": "https://globe.adsb.lol/?icao=a03129",
      "military": false,
      "on_ground": false,
      "pia": true,
      "position_seconds_ago": null,
      "registration": null,
      "seen_seconds_ago": 18.4,
      "source": "Mode S (no position)",
      "squawk": null,
      "track_deg": null,
      "type_code": null,
      "vertical_rate_fpm": null
    }
  ],
  "as_of": "2026-10-22T04:04:03Z",
  "count": 1,
  "flight_status": "any",
  "more_available": false,
  "total": 1
}
```

### Look up aircraft by callsign

Find the aircraft flying under a callsign, such as BAW256 for British Airways flight 256, and get where it is now: position, altitude, speed, registration, type and squawk. Give one or several. A callsign not in the air right now is listed under 'not_seen' rather than failing the step. No API key required.

**Inputs**

- Callsign (`callsigns`, text, required): The callsign as broadcast: the airline's ICAO code and flight number (BAW256, not BA256), or a registration for a private flight. Several can be given separated by commas, up to 100.

**Outputs**

- `aircraft` (list): The aircraft with those callsigns that adsb.lol is tracking right now.
- `as_of` (text): When adsb.lol's live picture was taken, in UTC (ISO 8601).
- `count` (number): How many aircraft came back.
- `found` (true/false): Whether any of them is being tracked right now. False is an answer, not a failure: the aircraft may be parked with its transponder off, or out of range of every receiver.
- `not_seen` (list): The callsigns asked for that are not being tracked right now.

**Example output**

```json
{
  "aircraft": [
    {
      "altitude_baro_ft": 9000,
      "altitude_geom_ft": 9450,
      "bearing_deg": null,
      "callsign": "BAW16",
      "category": "A5",
      "category_description": "Heavy (over 300,000 lb)",
      "distance_nm": null,
      "emergency": null,
      "emergency_description": null,
      "ground_speed_kt": 286.4,
      "hex": "406f72",
      "ladd": false,
      "latitude": 51.465363,
      "longitude": 0.051146,
      "map_url": "https://globe.adsb.lol/?icao=406f72",
      "military": false,
      "on_ground": false,
      "pia": false,
      "position_seconds_ago": 0.4,
      "registration": "G-ZBKF",
      "seen_seconds_ago": 0.2,
      "source": "ADS-B",
      "squawk": "4432",
      "track_deg": 268.9,
      "type_code": "B789",
      "vertical_rate_fpm": -1088
    }
  ],
  "as_of": "2026-10-22T04:04:03Z",
  "count": 1,
  "found": true,
  "not_seen": []
}
```

### Look up aircraft by hex code

Look up aircraft by their ICAO hex code, the transponder address that never changes for an airframe, and get where each is now: position, altitude, speed, callsign and squawk. Give one or several. One not in the air right now is listed under 'not_seen' rather than failing the step. No API key required.

**Inputs**

- Hex code (`hex_codes`, text, required): The aircraft's 6-character ICAO hex code, such as 4CA87C, in any case. Several can be given separated by commas, up to 100, or a list from an earlier step.

**Outputs**

- `aircraft` (list): The aircraft with those hex codes that adsb.lol is tracking right now.
- `as_of` (text): When adsb.lol's live picture was taken, in UTC (ISO 8601).
- `count` (number): How many aircraft came back.
- `found` (true/false): Whether any of them is being tracked right now. False is an answer, not a failure: the aircraft may be parked with its transponder off, or out of range of every receiver.
- `not_seen` (list): The hex codes asked for that are not being tracked right now.

**Example output**

```json
{
  "aircraft": [
    {
      "altitude_baro_ft": 9000,
      "altitude_geom_ft": 9450,
      "bearing_deg": null,
      "callsign": "BAW16",
      "category": "A5",
      "category_description": "Heavy (over 300,000 lb)",
      "distance_nm": null,
      "emergency": null,
      "emergency_description": null,
      "ground_speed_kt": 286.4,
      "hex": "406f72",
      "ladd": false,
      "latitude": 51.465363,
      "longitude": 0.051146,
      "map_url": "https://globe.adsb.lol/?icao=406f72",
      "military": false,
      "on_ground": false,
      "pia": false,
      "position_seconds_ago": 0.4,
      "registration": "G-ZBKF",
      "seen_seconds_ago": 0.2,
      "source": "ADS-B",
      "squawk": "4432",
      "track_deg": 268.9,
      "type_code": "B789",
      "vertical_rate_fpm": -1088
    }
  ],
  "as_of": "2026-10-22T04:04:03Z",
  "count": 1,
  "found": true,
  "not_seen": [
    "4ca87c"
  ]
}
```

### Look up aircraft by registration

Find an aircraft by its registration (tail number), such as G-XLEA, and get where it is now: position, altitude, speed, callsign and squawk. Give one or several. One not in the air right now is listed under 'not_seen' rather than failing the step. No API key required.

**Inputs**

- Registration (`registrations`, text, required): The registration as painted on the aircraft, with its hyphen, in any case. Several can be given separated by commas, up to 100.

**Outputs**

- `aircraft` (list): The aircraft with those registrations that adsb.lol is tracking right now.
- `as_of` (text): When adsb.lol's live picture was taken, in UTC (ISO 8601).
- `count` (number): How many aircraft came back.
- `found` (true/false): Whether any of them is being tracked right now. False is an answer, not a failure: the aircraft may be parked with its transponder off, or out of range of every receiver.
- `not_seen` (list): The registrations asked for that are not being tracked right now.

**Example output**

```json
{
  "aircraft": [
    {
      "altitude_baro_ft": 9000,
      "altitude_geom_ft": 9450,
      "bearing_deg": null,
      "callsign": "BAW16",
      "category": "A5",
      "category_description": "Heavy (over 300,000 lb)",
      "distance_nm": null,
      "emergency": null,
      "emergency_description": null,
      "ground_speed_kt": 286.4,
      "hex": "406f72",
      "ladd": false,
      "latitude": 51.465363,
      "longitude": 0.051146,
      "map_url": "https://globe.adsb.lol/?icao=406f72",
      "military": false,
      "on_ground": false,
      "pia": false,
      "position_seconds_ago": 0.4,
      "registration": "G-ZBKF",
      "seen_seconds_ago": 0.2,
      "source": "ADS-B",
      "squawk": "4432",
      "track_deg": 268.9,
      "type_code": "B789",
      "vertical_rate_fpm": -1088
    }
  ],
  "as_of": "2026-10-22T04:04:03Z",
  "count": 1,
  "found": true,
  "not_seen": []
}
```
