---
title: "Airspace Warning"
method: GET
path: "/openapi/v2.0/workspaces/{workspace_id}/air-sense-warnings"
tags: ["Map/Airspace Warning", "Map/Airspace Safety"]
---

# Airspace Warning

`GET /openapi/v2.0/workspaces/{workspace_id}/air-sense-warnings`

## Request

- Base URL: `` (relative, and it does not resolve against the document’s source URL)
- URL: `/openapi/v2.0/workspaces/{workspace_id}/air-sense-warnings`
- Auth: none required

Query the AirSense airspace alert data for each device in the workspace within the past 5 minutes

## Path parameters

- `workspace_id` string, uuid, required

## Query parameters

- `device_sns` string

## Headers

- `X-User-Token` string, required
- `X-Request-Id` string
- `X-Language` string

## Response `200`

success

- object
  - `code` integer: Non-zero Indicates Exception
  - `message` string: Message Prompt
  - `data` DeviceAirSenseWarnings[]: AirSense Alert Data List for Each Device
    - `sn` string: Dock/Device SN
    - `timestamp` integer: Alert Data Timestamp (Unix milliseconds)
    - `enable_waring` boolean: Whether this device has the AirSense alert feature enabled
    - `waring_events` AirSenseWarningEvent[]: List of currently active alert events (entries not updated within 5 minutes expire and are not returned)
      - `icao` string: ICAO Flight Identifier
      - `warning_level` 1 | 2 | 3: Alert level: 1=high risk, 2=medium risk, 3=low risk
      - `latitude` number, double: Target Latitude (WGS84, degrees)
      - `longitude` number, double: Target Longitude (WGS84, degrees)
      - `altitude` integer: Target Absolute Barometric Altitude (meters)
      - `altitude_type` integer: Altitude type: 0=pressure altitude, 1=geometric altitude
      - `heading` number, double: Target Heading Angle (degrees, 0=true north, clockwise)
      - `relative_altitude` number, double: Altitude difference relative to UAV (meters; positive means target is higher than UAV)
      - `vert_trend` integer: Vertical trend: 0=level, 1=climbing, 2=descending
      - `distance` number, double: Horizontal Distance from UAV (meters)

## Other responses

- `400`: Parameter Error
- `401`: Authentication Failed
- `403`: Insufficient Permission
- `404`: Resource Not Found
- `500`: Service Exception

---

[API](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud.md) - [All operations](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/revisions/aeef0010be34?raw)