---
title: "Get Project User List"
method: GET
path: "/openapi/v2.0/users"
tags: ["Organization & Project/Members & Permissions Management/Project Members"]
---

# Get Project User List

`GET /openapi/v2.0/users`

## Request

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

Paginated retrieval of all users under the project; supports role filter and fuzzy search by account or callsign

## Query parameters

- `q` string
- `prj_user_role` string
- `sort_column` string
- `sort_type` string
- `page` integer
- `page_size` integer

## Headers

- `X-Project-Uuid` string, uuid, required
- `X-User-Token` string, required
- `X-Request-Id` string
- `X-Language` string

## Response `200`

Business success (see 'Response Example' in the Markdown documentation for specific data)

- object
  - `code` integer: Non-zero Indicates Exception
  - `message` string: Message Prompt
  - `data` object: Business Data
    - `pagination` object: Pagination Info
      - `page` integer: Current page number, starts from 1
      - `page_size` integer: Items Per Page
      - `total` integer: Total Count
    - `list` object[]: Project user list (includes members brought in from the organization + project-independent members; unlike /members, this is paginated)
      - `user_id` string: DJI User ID (numeric string)
      - `account` string: User Account (phone/email)
      - `nickname` string: User callsign in this project; if user has not customized, organization callsign is used
      - `organization_user_callsign` string: User Callsign in Owning Organization
      - `is_user_project_callsign_updated` boolean: Whether User Has Ever Customized Project Callsign
      - `role` string: Project role: project-commander / project-member
      - `org_role` string: Organization role: organization-super-admin / organization-admin / organization-device-manager / organization-member, etc.
      - `roles_permissions` object[]: User's Role and Permission Snapshot in This Project
      - `is_phone_filled` boolean: Whether Phone Number Has Been Filled
      - `is_email_filled` boolean: Whether Email Has Been Filled

## Other responses

- `401`: Login expired or Authorization not provided
- `403`: Account does not have permission to access this resource
- `500`: Service temporarily unavailable, please retry later

---

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