Flights

List live flights in an area

Returns live aircraft positions within a geographic area — a bounding box (by=box with w/h) or a radius (by=radius with rad) around a center point — with optional altitude, aircraft-category, and military (mil=true) filters. Dimensions are kilometers by default, or nautical miles with unit=nm.

get/v1/flights

Request

  • Base URL
    https://customer-api.wingbits.com
  • Auth
    API key in header x-api-key

Query parameters

by'box' | 'radius'

Search type: 'box' or 'radius'

wnumber required

Width of search box (in km or nm based on unit)

hnumber required

Height of search box (in km or nm based on unit)

radnumber required

Search radius (in km or nm based on unit)

lanumber required

Latitude of center point (-90 to 90)

lonumber required

Longitude of center point (-180 to 180)

min_abnumber

Minimum altitude filter in feet

max_abnumber

Maximum altitude filter in feet

unit'km' | 'nm'

Unit for dimensions: 'km' or 'nm' (nautical miles)

categoriesstring

Comma-separated aircraft category codes (e.g., A1,A2,A7)

boolean
OR
'true' | 'false'

Only return aircraft flagged military in the aircraft registry. Opt-in only: false or omitted applies no filter.

Response

Default Response

hstring required

ICAO 24-bit aircraft address (hex)

lanumber required

Aircraft latitude in decimal degrees

lonumber required

Aircraft longitude in decimal degrees

cstring

Aircraft category code (ADS-B emitter category, e.g. A1–C2)

fstring

Flight number / callsign

thunknown
abunknown
agunknown
ronumber

Roll angle in degrees

rastring date-time

Timestamp when the message was received (ISO 8601)

ogunknown required
sqstring

Transponder squawk code

gsnumber

Ground speed in knots

tstring

Data type indicator (ADSB/ADSC/MLAT)

Changes

No recorded changes to this operation across all 1 revision of this API.