Target Reports

GetTargetReports streams one TargetReport for each tracked target update that matches the request filters.

Request Filters

sensor_filter

Sensors that must have contributed to the report. Leave empty to use all sensors associated with the token.

aircraft_filter

ICAO 24-bit transponder addresses. Leave empty to include all aircraft.

Response Contents

Each report can contain:

  • target: participant address and address type

  • timestamp and last_seen in milliseconds since Unix epoch

  • adsb: decoded ADS-B and Mode S state, if available

  • mlat: latest multilateration result, if available

  • counters: per-target signal counters

  • dropped_reports: absolute counter for skipped reports

Optional Fields

ADS-B and MLAT data are optional. Check field presence before reading optional submessages:

  • Python: HasField('adsb') and HasField('mlat')

  • Java: hasAdsb() and hasMlat()

Typical Uses

Use target reports for virtual radar displays, target-specific monitoring, and applications that need decoded aircraft state rather than raw Mode S frames.