Updated on 2026-10-27 GMT+08:00

Obtaining the Member List of a Specified Project

Function

This API is used to obtain project members.

Calling Method

For details, see Calling APIs.

Authorization Information

No identity policy-based permission required for calling this API.

URI

GET /v4/projects/{project_id}/members

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition A 32-character UUID. It uniquely identifies a project. Obtain a project ID by calling the API for querying projects. The value of project_id in the response message body is a project ID. Constraints A string of 32 characters consisting of letters and digits. Range N/A Default Value N/A

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
limit	Yes	Integer	Definition Page size. Constraints N/A Range 1–1000 Default Value 10
offset	Yes	Integer	Definition Start page number. The value starts from 0 and is an integer multiple of limit. The default value is 0. Constraints N/A Range 0–10000 Default Value 0

Request Parameters

None

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
members	Array of members objects	Definition: Project members.
total	Integer	Definition: Total number. Options: N/A

**Table 4** members
Parameter	Type	Description
domain_id	String	Definition Tenant ID. Range N/A
domain_name	String	Definition: Tenant name. Options: N/A
user_id	String	Definition User ID. Unique ID of a user in the system. Range N/A
user_name	String	Definition: Username. Options: N/A
user_num_id	Integer	Definition: Creator numId. User ID of the int type, which is required by some deletion APIs. Options: N/A
role_id	Integer	Definition: Member role ID, which is the key in the enumerated value. Options: –1: project creator 3: project manager 4: developer 5: test manager 6: tester 7: participant 8: viewer 9: O&M manager
nick_name	String	Definition: User nickname. Options: N/A
role_name	String	Definition: Role of a user. The value comes from the enumerated value range. Options: Project creator, project manager, developer, test manager, tester, participant, viewer, and O&M manager.
user_type	String	Definition: User type. Value range: User: IAM user Federation: federated account
forbidden	Integer	Definition: Whether the account is disabled. Options: 1 (disabled) and 0 (enabled)

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
error_code	String	Definition: Error code. Value range: N/A
error_msg	String	Definition: Error description. Value range: N/A

Status code: 401

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Definition: Error code. Value range: N/A
error_msg	String	Definition: Error description. Value range: N/A
request_id	String	Definition Request ID, which is automatically generated by the system. Range N/A

Example Requests

Obtaining the project member list

GET https://{endpoint}/v4/projects/e2da96a5d2c845e284f0ad47f8ca8cb1/members?limit=2&offset=0

GET https://{endpoint}/v4/projects/ac069b11a3524163ad6348953e2fe93e/members?limit=2&offset=0

Example Responses

Status code: 200

{
  "members" : [ {
    "domain_id" : "4e919d73499648e3b0292cd3cbef806a",
    "domain_name" : "demo_user_name",
    "user_id" : "a360371833bf4c558f796fd707b44daf",
    "user_name" : "demo_user_name",
    "user_num_id" : 4097,
    "role_id" : 7,
    "nick_name" : "name",
    "role_name" : "Project creator",
    "user_type" : "User",
    "forbidden" : 0
  } ],
  "total" : 1
}

Status Codes

Status Code	Description
200	OK
400	Bad Request
401	Unauthorized

Error Codes

See Error Codes.

Parent topic: Project members