---
title: "Get Project Device List"
method: GET
path: "/openapi/v2.0/manage/api/v1/projects/{uuid}/devices"
tags: ["Device Management/Device List Management/Project Device List"]
---

# Get Project Device List

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

Query all joined devices and their basic info under specified project, including device model, project call sign, organization call sign. **This API does not paginate; always returns all devices in project**; response `pagination` field is fixed to `page=1`; `page_size` equals `total`. Can use `usage=web_project_devices` to filter out remote controllers, payloads, batteries, and communication devices, retaining only aircraft and dock-type devices.

**Call Conditions**: any user with valid session can call; response contains only devices the user has view permission for in specified project.

## Path parameters

- `uuid` string, required

## Query parameters

- `usage` 'web_project_devices'
- `sort_column` 'nickname'
- `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: Device List Under Project (Paginated)
    - `list` object[]: Device List
      - `sn` string: Device Serial Number
      - `nickname` string: Device Alias
      - `device_model` object: Device Model Object
        - `key` string: Model Primary Key, format e.g. 0-67-0
        - `domain` string: Device Domain, e.g. drone / airport
        - `type` string: Main Model Number
        - `sub_type` string: Sub Model Number
        - `name` string: Model Name
        - `class` string: Device Category
        - `develop_code` string: R&D Code
      - `is_org_device` boolean: Is Organization Device
      - `device_organization_callsign` string, nullable: Device Call Sign in Organization
    - `pagination` object: Pagination Info
      - `page` integer: Current Page
      - `page_size` integer: Items Per Page
      - `total` integer: Total Count

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