---
title: "Query Organization Device O&M List"
method: GET
path: "/openapi/v2.0/manage/api/v1/organizations/{uuid}/manage-devices"
tags: ["Device Management/Device List Management/Organization Device List"]
---

# Query Organization Device O&M List

`GET /openapi/v2.0/manage/api/v1/organizations/{uuid}/manage-devices`

## Request

- Base URL: `https://41b04hdzmc.apifox.cn` (the document declares no server; this is the origin it was published from)
- URL: `https://41b04hdzmc.apifox.cn/openapi/v2.0/manage/api/v1/organizations/{uuid}/manage-devices`
- Auth: none required

Paginated query of device O&M details in organization by device type (Required, e.g. Aircraft/Dock/Communication Device/Battery, etc.); supports filtering by model primary key, online status, firmware upgrade status, workspace project, join time range, SN slice, and other multi-dimensional conditions; returns rich device O&M info (online status, firmware version, work status, associated devices, dock offline location, etc.). Frontend's "Device O&M Management" main table uses this API.

**Call Conditions**: caller must be organization administrator/super administrator or Device Maintainer. Device Maintainers can only see devices in projects they are authorized for.

**Pagination Characteristics**: Only paginated by database when `device_model_class=drone`; other types return full data (`page=1`, `page_size` equals `total`). **`list[]` field set** varies by device type (`drone` / `airport` / `communication` / `drone-battery` / `payload`); common fields include `device_sn / device_callsign / device_model / device_add_time / device_code / device_last_online_time`.

## Path parameters

- `uuid` string, required

## Query parameters

- `device_model_class` 'drone' | 'airport' | 'communication' | 'base_station', required
- `device_model_key` string[]
- `device_online_status` 'online' | 'offline'
- `device_working_status` number
- `firmware_status` integer[]
- `flysafe_database_upgrade_status` integer[]
- `device_sn` string[]
- `active_project` string[]
- `join_time_start` integer
- `join_time_end` integer
- `page` integer
- `page_size` integer
- `q` string
- `sort_column` string
- `sort_type` 'ASC' | 'DESC'

## Headers

- `x-user-token` string, required
- `X-Request-Id` string
- `X-Project-Uuid` string, required

## Response `200`

Success

- object
  - `code` integer, required: Business Status Code: 0=Success; non-zero=Error Code (see message for meaning)
  - `message` string: Error Description Message (Omitted on Success)
  - `data` object: Organization Device O&M Paginated List
    - `pagination` object: Pagination Metadata (effective only for drone; other types have page=1, page_size equal to total)
      - `page` integer: Current Page
      - `page_size` integer: Items Per Page
      - `total` integer: Total Count
    - `list` object[]: Device O&M Entry; field set varies by device type, see API description
      - `device_sn` string: Device Serial Number
      - `device_callsign` string: Device Organization Call Sign
      - `device_model` object: Model Object
        - `key` string: Device Model ID
        - `domain` string: Device Domain
        - `type` string: Main Model
        - `sub_type` string: Sub Model
        - `name` string: Model Name
        - `class` string: Device Type
        - `develop_code` string: Device Model Pairing Code
      - `device_add_time` integer: Organization Join Time (Second-Level Unix Timestamp)
      - `device_code` integer: Error code reported by device during firmware upgrade; 0=None
      - `device_last_online_time` integer, nullable: Last Online Time (Second-Level Unix Timestamp); null when never online
      - `device_active_project_uuid` string: Device's Current Workspace Project UUID (drone/airport/communication types have this field)
      - `device_active_project_name` string: Device Current Workspace Project Name
      - `device_active_other_organization` boolean: Whether Device is Working in Other Organization (drone only)
      - `is_user_can_enter_project` boolean: Whether Current User Can Enter Device's Project (drone only)
      - `project_member_role` string: Current User's Role in Device's Project (drone only)
      - `device_online_status` boolean: Online Status
      - `device_firmware_version` string: Current Firmware Version
      - `device_firmware_status` integer: Firmware Upgrade Status
      - `device_working_status` number, nullable: Current Working Status
      - `ota` object, nullable: Upgrade Progress
        - `status` string: OTA Upgrade Status
        - `progress` object: OTA Upgrade Progress
          - `percent` integer: Upgrade Progress Percentage
          - `current_step` integer: Current Upgrade Step
      - `device_state` object: Device Thing Model Real-time Data
      - `is_organization_device` boolean: Is Organization Device (drone)
      - `flysafe_database_upgrade_status` integer: Flight Safety Database Status (1/2/3, drone only)
      - `flysafe_database_version` string: Flight Safety Database Version (drone only)
      - `associate_drone_device_info` object, nullable: Associated Aircraft Info (Dock/Communication Device-Specific)
      - `associate_relay_device_info` object, nullable: Associated Relay Info (Dock/Communication Device-Specific)
      - `flysafe_database_upgrade` object, nullable: Flight Safety Database Upgrade Status (Dock/Communication Device-Specific)
      - `complete_machine_sn` string, nullable: Aircraft SN (Dock-Specific)
      - `device_battery_cycle_times` number: Battery Cycle Count (Battery Device-Specific)

## Other responses

- `400`: Invalid Request Parameter
- `500`: Server Internal Error

---

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