---
title: "Aircraft by callsign"
method: GET
path: "/v2/callsign/{callsign}"
tags: ["Aircraft"]
---

# Aircraft by callsign

`GET /v2/callsign/{callsign}`

## Request

- Base URL: `https://api.adsbiq.com`
- URL: `https://api.adsbiq.com/v2/callsign/{callsign}`
- Auth: HTTP bearer

## Path parameters

- `callsign` string, required

## Response `200`

Bounded current aircraft collection

- AircraftCollection
  - `now` number
  - `total` integer, required
  - `ac` Aircraft[], required
    - `hex` string, required
    - `flight` string
    - `r` string: Registration
    - `t` string: ICAO aircraft type
    - `lat` number
    - `lon` number
    - `alt_baro` union
      - number
      - 'ground'
    - `alt_geom` number
    - `gs` number
    - `track` number
    - `squawk` string
    - `emergency` string
    - `route_origin` string
    - `route_dest` string
    - `seen` number
    - `origin_airport` Airport
      - `icao` string, required
      - `iata` string, nullable
      - `local` string, nullable
      - `name` string, required
      - `city` string, nullable
      - `country` string, nullable
      - `type` string, nullable
      - `lat` number, required
      - `lon` number, required
      - `distance_nm` number
    - `destination_airport` Airport
      - `icao` string, required
      - `iata` string, nullable
      - `local` string, nullable
      - `name` string, required
      - `city` string, nullable
      - `country` string, nullable
      - `type` string, nullable
      - `lat` number, required
      - `lon` number, required
      - `distance_nm` number
  - `msg` string
  - `community` Community
    - `code` 'community_powered' | 'local_receiver_absent', required
    - `surface` string, required
    - `optional` true, required
    - `existing_receivers` true, required
    - `exclusive` false, required
    - `url` 'https://adsbiq.com/join', uri, required
    - `agent_hint` string, required

## Other responses

- `401`: Missing or invalid feeder authentication
- `429`: Request rate limit exceeded

---

[API](https://skmtc.dev/adsbiq/apis/adsbiq-live-aircraft-api.md) · [All operations](https://skmtc.dev/adsbiq/apis/adsbiq-live-aircraft-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adsbiq/apis/adsbiq-live-aircraft-api/revisions/1fad90817e27?raw)