---
title: "Get HMS Information"
method: GET
path: "/openapi/v2.0/device/hms"
tags: ["Device Management"]
---

# Get HMS Information

`GET /openapi/v2.0/device/hms`

## Request

- Base URL: `` (relative, and it does not resolve against the document’s source URL)
- URL: `/openapi/v2.0/device/hms`
- Auth: none required

Get Health Management System info; pass in `device_sn_list` to retrieve the abnormal status info for a list of devices.

⚠️ This API only returns alerts from the last 24 hours, with a maximum of 100 alert records per device.

## Query parameters

- `device_sn_list` string, required

## Headers

- `X-User-Token` string, required
- `X-Project-Uuid` string, required
- `X-Request-Id` string, uuid
- `X-Language` 'zh' | 'en'

## Response `200`

- object
  - `code` integer, required: Non-zero Indicates Exception
  - `message` string, required: Message Prompt
  - `data` object, required: Business data, device HMS alert list
    - `list` object[], required: HMS List
      - `device_sn` string: Device SN
      - `device_hms` object: HMS Detailed Info
        - `list` object[]: Data List
          - `level` 'notification' | 'reminder' | 'warning': HMS Level
          - `module` 'flight_mission' | 'device_management' | 'media' | 'hms': HMS Module
          - `in_the_sky` 'on_the_ground' | 'in_the_sky': Whether Flying
          - `imminent` boolean: Whether Time-Sensitive
          - `code` string: HMS Alert Code
          - `message` string: HMS Alert Information
          - `args` object: HMS alert additional parameters, used for placeholder rendering
          - `hms_id` string: HMS Alert ID
          - `status` 1 | 2: Alert status: 1=live, 2=non-live
          - `status_key` string: Status aggregation/dedup key
          - `begin_time` integer: Alert start time (milliseconds)
          - `end_time` integer: Alert end time (milliseconds)
          - `device_data_create_time` integer: Data creation time (milliseconds)
          - `device_data_update_time` integer: Data update time (milliseconds)
          - `domain_type` string: Device domain type: drone/drone_nest/relay/base_station etc.
          - `sub_hms_list` object[]: Root-cause HMS list (same structure as parent HMS item, without sub_hms_list itself)

## Other responses

- `400`: Invalid request parameters (incorrect format, missing required fields, etc.)
- `401`: Authentication failed (token invalid or expired)
- `403`: Insufficient permission (token does not have the corresponding permission in this project/organization)
- `500`: Server Internal Error

---

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