---
title: "Get traffic records by geo window"
method: GET
path: "/api/v1/tis/traffic/geo-window"
tags: ["Traffic Information Service"]
---

# Get traffic records by geo window

`GET /api/v1/tis/traffic/geo-window`

## Request

- Base URL: `http://localhost:8486`
- URL: `http://localhost:8486/api/v1/tis/traffic/geo-window`
- Auth: API key in header `x-auth-token`

Retrieves traffic records within the specified geographic bounds

## Query parameters

- `minLat` number, double, required
- `maxLat` number, double, required
- `minLng` number, double, required
- `maxLng` number, double, required

## Response `200`

Traffic records found

- TrafficGeoWindowResponse: Traffic snapshot for a map viewport with MQTT subscription plan for realtime updates
  - `records` TrafficRecord[]: Traffic records in the requested geographic window
    - `id` string, uuid: Unique identifier for the traffic record
    - `uas` UAS: Unmanned aircraft system information
      - `ua_type` 'NotDeclared' | 'Aeroplane' | 'Helicopter' | 'Gyroplane' | 'HybridLift' | 'Ornithopter' | 'Glider' | 'Kite' | 'FreeBalloon' | 'CaptiveBalloon' | 'Airship' | 'FreeFallOrParachute' | 'Rocket' | 'TetheredPoweredAircraft' | 'GroundObstacle' | 'Other': Type of unmanned aircraft
      - `uas_id` UASID: Unmanned aircraft system identification
        - `serial_number` string: This is expressed in the CTA-2063-A Serial Number format.
        - `operator_reg_num` string: Operator registration number.
      - `eu_classification` UAClassificationEU: EU classification of the unmanned aircraft
        - `category` 'EUCategoryUndefined' | 'Open' | 'Specific' | 'Certified', required
        - `class` 'EUClassUndefined' | 'Class0' | 'Class1' | 'Class2' | 'Class3' | 'Class4' | 'Class5' | 'Class6', required
    - `ts` Time: Timestamp of the last message received
      - `value` string, required: RFC3339-formatted time/date string. The time zone must be 'Z'.
      - `format` 'RFC3339', required
    - `ts_accuracy` number, float: Timestamp accuracy in seconds
    - `status` 'Undeclared' | 'Ground' | 'Airborne' | 'Emergency' | 'RemoteIDSystemFailure': Status of the aircraft
    - `position` Position: Position information of the aircraft
      - `lat` number, double, required: Degrees of latitude north of the equator, with reference to the WGS84 ellipsoid. Invalid, No Value, or Unknown is 0 degrees (both Lat/Lon).
      - `lng` number, double, required: Degrees of longitude east of the Prime Meridian, with reference to the WGS84 ellipsoid. Invalid, No Value, or Unknown is 0 degrees (both Lat/Lon).
      - `altitude_hae` number, float, required: Geodetic altitude (HAE - Height Above Ellipsoid): aircraft distance above the WGS84 ellipsoid as measured along a line that passes through the aircraft and is normal to the surface of the WGS84 ellipsoid. This value is provided in meters and must have a minimum resolution of 1 meter. Invalid, No Value or Unknown is -1000 m.
      - `accuracy_h` 'HAUnknown' | 'HA10NMPlus' | 'HA10NM' | 'HA4NM' | 'HA2NM' | 'HA1NM' | 'HA05NM' | 'HA03NM' | 'HA01NM' | 'HA005NM' | 'HA30m' | 'HA10m' | 'HA3m' | 'HA1m', required
      - `accuracy_v` 'VAUnknown' | 'VA150mPlus' | 'VA150m' | 'VA45m' | 'VA25m' | 'VA10m' | 'VA3m' | 'VA1m', required
      - `pressure_altitude` number, float: The uncorrected altitude (based on reference standard 29.92 inHg, 1013.25 mb) provides a reference for algorithms that utilize "altitude deltas" between aircraft. This value is provided in meters and must have a minimum resolution of 1 meter. Omitted or null when not reported; legacy invalid/unknown marker -1000 m may still appear.
      - `altitude_amsl` number, float: Altitude Above Mean Sea Level (AMSL) in meters. This value is calculated from HAE (Height Above Ellipsoid) by subtracting geoid undulation. This value is provided in meters and must have a minimum resolution of 1 meter. Invalid, No Value or Unknown is null.
      - `height_above_takeoff` Height
        - `distance` number, float, required: Distance above reference datum. This value is provided in meters and must have a minimum resolution of 1 meter. Invalid, No Value or Unknown is -1000 m.
      - `height_above_ground_level` Height
        - `distance` number, float, required: Distance above reference datum. This value is provided in meters and must have a minimum resolution of 1 meter. Invalid, No Value or Unknown is -1000 m.
    - `track` number, float: Track angle in degrees
    - `speed_acc` 'SAUnknown' | 'SA10mpsPlus' | 'SA10mps' | 'SA3mps' | 'SA1mps' | 'SA03mps': Speed accuracy classification
    - `speed_ms` number, float: Speed in meters per second
    - `vertical_speed` number, float: Vertical speed in meters per second
    - `ts_last_msg` Time: Timestamp of the last message received
      - `value` string, required: RFC3339-formatted time/date string. The time zone must be 'Z'.
      - `format` 'RFC3339', required
    - `icao_hex` string: ICAO 24-bit address in hexadecimal format
    - `callsign` string: Aircraft callsign
    - `source` string: Source of the traffic data
    - `speed_knots` number, float: Speed in knots
    - `category` 'A0' | 'A1' | 'A2' | 'A3' | 'A4' | 'A5' | 'A6' | 'A7' | 'B0' | 'B1' | 'B2' | 'B3' | 'B4' | 'B5' | 'B6' | 'B7' | 'C0' | 'C1' | 'C2' | 'C3' | 'C4' | 'C5' | 'C6' | 'C7': Aircraft category classification
    - `alt_diff_geo_baro_ft` number, float: Altitude difference between geometric and barometric in feet
    - `heading` number, float: Heading in degrees
    - `squawk` integer: Squawk code
    - `dist_from_receiver` number, float: Distance from receiver in meters
    - `record_age_s` integer: Age of the record in seconds
    - `beacon_type` string: Original type from source (e.g. SafeSky: UAV, HELICOPTER, JET, STATIC_OBJECT). Used for icon and label.
    - `volume_geometry` object: Optional GeoJSON Polygon/MultiPolygon for STATIC_OBJECT. Map draws this shape instead of a circle.
    - `remarks` string: Free text note (e.g. operation area purpose). From SafeSky remarks.
    - `upper_limit_agl` number, float: Upper altitude limit for operation volume (m AGL). From SafeSky max_altitude when present.
    - `lower_limit_agl` number, float: Lower altitude limit for operation volume (m AGL). From SafeSky min_altitude when present.
  - `realtime` RealtimeMapSubscriptions: MQTT topic filters for hierarchical realtime map grid subscriptions
    - `gridMaxLevel` integer: Grid detail level used for topic planning (1=coarse … 3=leaf)
    - `mqttTopics` string[]: MQTT subscribe filters for this map stream (may end with /# for segment wildcards)

## Other responses

- `400`: Invalid parameters
- `500`: Internal server error

---

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