Flights

get

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

/v1/flights

Get flights within a geographic area

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

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

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,
    "ro": 1,
    "ra": "2026-03-16T22:29:21.918Z",
    "og": null,
    "sq": "text",
    "gs": 1
  }
]

post

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

/v1/flights

Get flights within multiple geographic areas

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,
        "ro": 1,
        "ra": "2026-03-16T22:29:21.918Z",
        "og": null,
        "sq": "text",
        "gs": 1
      }
    ]
  }
]

get

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

/v1/flights/{id}

Get a flight by ID

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-03-16T22:29:21.918Z",
    "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

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

/v1/flights/{id}/path

Get a flight path by ID

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
      }
    ]
  }
}

get

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

/v1/flights/search

Search for a flight by callsign, ICAO hex, or registration

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,
    "ro": 1,
    "ra": "2026-03-16T22:29:21.918Z"
  },
  "message": "text"
}

get

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

/v1/flights/details/{icao24}

Retrieve detailed information about an aircraft using its 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:

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"
}