---
title: "List live flights in multiple areas"
method: POST
path: "/v1/flights"
tags: ["Flights"]
---

# List live flights in multiple areas

`POST /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`

Batch variant of the area query: send several box or radius queries in one request and get results per query, each echoing its `alias`. Each query supports the same optional altitude, aircraft-category, and military (`mil=true`) filters.

## Request body

- union[]
  - union
    - object
      - `by` 'box': Search type: 'box' or 'radius'
      - `w` number, required: Width of search box (in km or nm based on unit)
      - `h` number, required: Height of search box (in km or nm based on unit)
      - `la` number, required: Latitude of center point (-90 to 90)
      - `lo` number, required: Longitude of center point (-180 to 180)
      - `min_ab` number: Minimum altitude filter in feet
      - `max_ab` number: Maximum altitude filter in feet
      - `unit` 'km' | 'nm': Unit for dimensions: 'km' or 'nm' (nautical miles)
      - `categories` string: Comma-separated aircraft category codes (e.g., A1,A2,A7)
      - `mil` union: Only return aircraft flagged military in the aircraft registry. Opt-in only: false or omitted applies no filter.
        - boolean
        - 'true' | 'false'
      - `alias` string, required: lookup alias for response
    - object
      - `by` 'radius': Search type: 'box' or 'radius'
      - `rad` number, required: Search radius (in km or nm based on unit)
      - `la` number, required: Latitude of center point (-90 to 90)
      - `lo` number, required: Longitude of center point (-180 to 180)
      - `min_ab` number: Minimum altitude filter in feet
      - `max_ab` number: Maximum altitude filter in feet
      - `unit` 'km' | 'nm': Unit for dimensions: 'km' or 'nm' (nautical miles)
      - `categories` string: Comma-separated aircraft category codes (e.g., A1,A2,A7)
      - `mil` union: Only return aircraft flagged military in the aircraft registry. Opt-in only: false or omitted applies no filter.
        - boolean
        - 'true' | 'false'
      - `alias` string, required: lookup alias for response

## Response `200`

Default Response

- object[]
  - `alias` string, required
  - `data` object[], required
    - `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)