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

# Query Organization Device Simplified List

`GET /openapi/v2.0/manage/api/v1/organizations/{uuid}/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}/devices`
- Auth: none required

Paginated query of simplified list of all devices in organization; each record contains only 4 core info items: device SN, device call sign, device type, model enum object. Suitable for dropdown lists in scenarios like "Project Edit" where devices need to be picked from organization device pool; fewer fields, lighter response. New business is recommended to use "Query Organization Device O&M List" API.

**Call Conditions**: caller must satisfy either of the following — is organization administrator/super administrator; or has "Team-View Device" permission in project specified by `project_uuid`.

**`usage` Values**: `web_organization_devices` indicates "Project Edit-Organization Device" mode; `q` keyword only matches organization call sign + device model name; if omitted or other value, `q` defaults to matching Device SN / Device Call Sign / Aircraft SN.

## Path parameters

- `uuid` string, required

## Query parameters

- `page` integer
- `page_size` integer
- `q` string
- `sort_column` 'device_sn' | 'device_callsign' | 'device_last_online_time' | 'device_add_time'
- `sort_type` 'ASC' | 'DESC'
- `usage` 'web_organization_devices'
- `project_uuid` string

## 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 Paginated List
    - `pagination` object: Pagination Info
      - `page` integer: Current Page
      - `page_size` integer: Items Per Page
      - `total` integer: Total Matching Devices
    - `list` object[]: Device List
      - `sn` string: Device Serial Number (SN)
      - `nickname` string: Device Call Sign in Organization
      - `type` string: Device Type, equals device_model.class (redundant field; retained for legacy client compatibility)
      - `device_model` object: Device Model Info
        - `key` string: Model Primary Key, globally unique, format 0-67-0
        - `domain` string: Model Domain, e.g. drone / airport
        - `type` string: Model Main Model, numeric string, e.g. "67"
        - `sub_type` string: Model Sub Model, numeric string, e.g. "0"
        - `name` string: Model Name, e.g. "Matrice 30"
        - `class` string: Device Type, Enum: drone (Aircraft) / airport (Dock) / rc (Remote Controller) / payload (Mounted Payload) / communication (Communication Device) / drone-battery (Aircraft Battery) / relay (Relay) / base_station (Base Station)
        - `develop_code` string: Device Model Pairing Code

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