---
title: "Search flights by callsign, hex, or registration"
method: GET
path: "/v1/flights/search"
tags: ["Flights"]
---

# Search flights by callsign, hex, or registration

`GET /v1/flights/search`

## Request

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

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.

## Query parameters

- `query` string, required

## Response `200`

Default Response

- object
  - `flight` union, required
    - 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)
    - unknown
  - `message` string

## 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)