Flights

Live aircraft positions, flight search, flight paths, and aircraft details from the Wingbits network.

List live flights in an area

get

http://localhost:3002https://customer-api.wingbits.com

/v1/flights

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 and aircraft-category filters. Dimensions are kilometers by default, or nautical miles with unit=nm.

Authorizations

apiKeyAuth

x-api-keystringRequired

API key for accessing protected endpoints

Query parameters

bystring · enumOptional

Search type: 'box' or 'radius'

Default: boxPossible values:

wnumberRequired

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

hnumberRequired

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

radnumberRequired

Search radius (in km or nm based on unit)

lanumber · min: -90 · max: 90Required

Latitude of center point (-90 to 90)

lonumber · min: -180 · max: 180Required

Longitude of center point (-180 to 180)

min_abnumberOptional

Minimum altitude filter in feet

max_abnumberOptional

Maximum altitude filter in feet

unitstring · enumOptional

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

Default: nmPossible values:

categoriesstringOptional

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

Responses

200

Default Response

application/json

hstringRequired

lanumber · min: -90 · max: 90Required

lonumber · min: -180 · max: 180Required

cstringOptional

fstringOptional

thanyOptional

abanyOptional

aganyOptional

ronumberOptional

rastring · date-timeOptionalPattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

oganyRequired

Whether aircraft is on ground

sqstringOptional

Transponder squawk code

gsnumberOptional

Speed over ground

tstringOptional

Data type indicator (ADSB/ADSC/MLAT)

400

Default Response

application/json

401

Default Response

application/json

402

Default Response

application/json

429

Default Response

application/json

500

Default Response

application/json

get/v1/flights

HTTPcURLJavaScriptPython

GET /v1/flights?w=1&h=1&rad=1&la=1&lo=1 HTTP/1.1
Host: localhost:3002
x-api-key: YOUR_API_KEY
Accept: */*

[
  {
    "h": "text",
    "la": 1,
    "lo": 1,
    "c": "text",
    "f": "text",
    "th": null,
    "ab": null,
    "ag": null,
    "ro": 1,
    "ra": "2026-07-19T03:52:51.892Z",
    "og": null,
    "sq": "text",
    "gs": 1,
    "t": "text"
  }
]

List live flights in multiple areas

post

http://localhost:3002https://customer-api.wingbits.com

/v1/flights

Batch variant of the area query: send several box or radius queries in one request and get results per query, each echoing its alias.

Authorizations

apiKeyAuth

x-api-keystringRequired

API key for accessing protected endpoints

Bodyall of[]

application/json

anyOptional

or

and

Responses

200

Default Response

application/json

aliasstringRequired

400

Default Response

application/json

401

Default Response

application/json

402

Default Response

application/json

429

Default Response

application/json

500

Default Response

application/json

post/v1/flights

HTTPcURLJavaScriptPython

POST /v1/flights HTTP/1.1
Host: localhost:3002
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 124

[
  {
    "by": "box",
    "w": 1,
    "h": 1
  },
  {
    "by": "box",
    "la": 1,
    "lo": 1,
    "min_ab": 1,
    "max_ab": 1,
    "unit": "nm",
    "categories": "text"
  },
  {
    "alias": "text"
  }
]

[
  {
    "alias": "text",
    "data": [
      {
        "h": "text",
        "la": 1,
        "lo": 1,
        "c": "text",
        "f": "text",
        "th": null,
        "ab": null,
        "ag": null,
        "ro": 1,
        "ra": "2026-07-19T03:52:51.892Z",
        "og": null,
        "sq": "text",
        "gs": 1,
        "t": "text"
      }
    ]
  }
]

Get a flight by ID

get

http://localhost:3002https://customer-api.wingbits.com

/v1/flights/{id}

Returns a single flight by its identifier, including current position and flight metadata. When the aircraft is no longer live but its recent track is still retained, returns flight: null with hexId and lastPosition (the last tracked point).

Authorizations

apiKeyAuth

x-api-keystringRequired

API key for accessing protected endpoints

Path parameters

idstringRequired

Item identifier

Responses

200

Default Response

application/json

flightany ofRequired

or

undefined · enum · nullableOptionalPossible values:

hexIdstringOptional

messagestringOptional

401

Default Response

application/json

402

Default Response

application/json

404

Default Response

application/json

429

Default Response

application/json

500

Default Response

application/json

get/v1/flights/{id}

HTTPcURLJavaScriptPython

GET /v1/flights/{id} HTTP/1.1
Host: localhost:3002
x-api-key: YOUR_API_KEY
Accept: */*

{
  "flight": {
    "la": 1,
    "lo": 1,
    "c": "text",
    "f": "text",
    "ab": null,
    "ra": "2026-07-19T03:52:51.892Z",
    "d": "text",
    "h": "text",
    "tr": null,
    "th": null,
    "og": null,
    "a": 1,
    "ag": 1,
    "br": 1,
    "em": "text",
    "gr": 1,
    "gs": 1,
    "gv": 1,
    "i": 1,
    "m": 1,
    "mh": 1,
    "n": 1,
    "naf": 1,
    "nam": 1,
    "nb": 1,
    "nh": 1,
    "np": 1,
    "nq": 1,
    "nv": 1,
    "oat": 1,
    "port": 1,
    "rc": 1,
    "ro": 1,
    "rs": 1,
    "s": 1,
    "sda": 1,
    "sn": 1,
    "sp": 1,
    "spi": 1,
    "sq": "text",
    "st": "text",
    "t": "text",
    "tat": 1,
    "trr": 1,
    "ts": 1,
    "v": 1,
    "nm": [
      "text"
    ]
  },
  "hexId": "text",
  "lastPosition": {
    "la": 1,
    "lo": 1,
    "alt": 1,
    "timestamp": 1
  },
  "message": "text"
}

Get a flight path

get

http://localhost:3002https://customer-api.wingbits.com

/v1/flights/{id}/path

Returns the position track for a flight: an ordered list of latitude, longitude, altitude, and timestamp points.

Authorizations

apiKeyAuth

x-api-keystringRequired

API key for accessing protected endpoints

Path parameters

idstringRequired

Item identifier

Responses

200

Default Response

application/json

401

Default Response

application/json

402

Default Response

application/json

404

Default Response

application/json

429

Default Response

application/json

500

Default Response

application/json

get/v1/flights/{id}/path

HTTPcURLJavaScriptPython

GET /v1/flights/{id}/path HTTP/1.1
Host: localhost:3002
x-api-key: YOUR_API_KEY
Accept: */*

{
  "flight": {
    "id": "text",
    "name": "text",
    "path": [
      {
        "altitude": 1,
        "timestamp": 1,
        "latitude": 1,
        "longitude": 1
      }
    ]
  }
}

Search flights by callsign, hex, or registration

get

http://localhost:3002https://customer-api.wingbits.com

/v1/flights/search

Finds a live flight by callsign (e.g. BAW172), ICAO 24-bit hex address (e.g. 4ca8d3), or registration (e.g. EI-DVN). Returns null when no matching flight is currently visible to the network.

Authorizations

apiKeyAuth

x-api-keystringRequired

API key for accessing protected endpoints

Query parameters

querystring · min: 3 · max: 15Required

Flight callsign, ICAO hex, or registration

Responses

200

Default Response

application/json

flightany ofRequired

or

undefined · enum · nullableOptionalPossible values:

messagestringOptional

400

Default Response

application/json

401

Default Response

application/json

402

Default Response

application/json

429

Default Response

application/json

500

Default Response

application/json

get/v1/flights/search

HTTPcURLJavaScriptPython

GET /v1/flights/search?query=text HTTP/1.1
Host: localhost:3002
x-api-key: YOUR_API_KEY
Accept: */*

{
  "flight": {
    "h": "text",
    "la": 1,
    "lo": 1,
    "c": "text",
    "f": "text",
    "th": null,
    "ab": null,
    "ag": null,
    "ro": 1,
    "ra": "2026-07-19T03:52:51.892Z"
  },
  "message": "text"
}

Get aircraft details by ICAO24

get

http://localhost:3002https://customer-api.wingbits.com

/v1/flights/details/{icao24}

Returns detailed aircraft information — type, registration, operator, and related metadata — for an ICAO 24-bit address.

Authorizations

apiKeyAuth

x-api-keystringRequired

API key for accessing protected endpoints

Path parameters

icao24string · min: 1Required

ICAO 24-bit address

Responses

200

Default Response

application/json

icao24stringRequired

registrationany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

manufacturerIcaoany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

manufacturerNameany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

modelany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

typecodeany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

serialNumberany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

lineNumberany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

icaoAircraftTypeany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

operatorany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

operatorCallsignany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

operatorIcaoany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

operatorIataany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

ownerany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

registeredany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

reguntilany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

statusany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

builtany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

firstFlightDateany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

enginesany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

modesany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

adsbany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

acarsany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

notesany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

categoryDescriptionany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

milany ofRequired

booleanOptional

or

undefined · enum · nullableOptionalPossible values:

faaPiaany ofRequired

booleanOptional

or

undefined · enum · nullableOptionalPossible values:

faaLaddany ofRequired

booleanOptional

or

undefined · enum · nullableOptionalPossible values:

shortTypeany ofRequired

stringOptional

or

undefined · enum · nullableOptionalPossible values:

401

Default Response

application/json

402

Default Response

application/json

404

Default Response

application/json

429

Default Response

application/json

500

Default Response

application/json

get/v1/flights/details/{icao24}

HTTPcURLJavaScriptPython

GET /v1/flights/details/{icao24} HTTP/1.1
Host: localhost:3002
x-api-key: YOUR_API_KEY
Accept: */*

{
  "icao24": "text",
  "registration": "text",
  "manufacturerIcao": "text",
  "manufacturerName": "text",
  "model": "text",
  "typecode": "text",
  "serialNumber": "text",
  "lineNumber": "text",
  "icaoAircraftType": "text",
  "operator": "text",
  "operatorCallsign": "text",
  "operatorIcao": "text",
  "operatorIata": "text",
  "owner": "text",
  "registered": "text",
  "reguntil": "text",
  "status": "text",
  "built": "text",
  "firstFlightDate": "text",
  "engines": "text",
  "modes": "text",
  "adsb": "text",
  "acars": "text",
  "notes": "text",
  "categoryDescription": "text",
  "mil": true,
  "faaPia": true,
  "faaLadd": true,
  "shortType": "text"
}