---
title: "List live flights in an area"
method: GET
path: "/v1/flights"
tags: ["Flights"]
---

# List live flights in an area

`GET /v1/flights`

## Request

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

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`.

## Query parameters

- `by` 'box' | 'radius'
- `w` number, required
- `h` number, required
- `rad` number, required
- `la` number, required
- `lo` number, required
- `min_ab` number
- `max_ab` number
- `unit` 'km' | 'nm'
- `categories` string
- `mil` union
  - boolean
  - 'true' | 'false'

## Response `200`

Default Response

- object[]
  - `h` string, required: ICAO 24-bit aircraft address (hex)
  - `la` number, required: Aircraft latitude in decimal degrees
  - `lo` number, required: Aircraft longitude in decimal degrees
  - `c` string: Aircraft category code (ADS-B emitter category, e.g. A1–C2)
  - `f` string: Flight number / callsign
  - `th` unknown
  - `ab` unknown
  - `ag` unknown
  - `ro` number: Roll angle in degrees
  - `ra` string, date-time: Timestamp when the message was received (ISO 8601)
  - `og` unknown, required
  - `sq` string: Transponder squawk code
  - `gs` number: Ground speed in knots
  - `t` string: Data type indicator (ADSB/ADSC/MLAT)

## Other responses

- `400`: Default Response
- `401`: Default Response
- `402`: Default Response
- `429`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/wingbits/apis/wingbits-customer-api.md) - [All operations](https://skmtc.dev/wingbits/apis/wingbits-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wingbits/apis/wingbits-customer-api/revisions/b67489518de1?raw)