✨ Get project members paginated | API Reference

This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise

Retrieve the members for a specific project.

Response Fields:

implicit_member (boolean): Indicates if the user is an implicit member.
- true: User has access via workspace membership or organization role (Administrator/Owner)
- false: User is an explicit project member (added directly to the project)
project_role (string|null): Project-specific role override if assigned, null otherwise

Note: Users can have both explicit membership AND implicit access. The implicit_member field is false if the user has an explicit ProjectMember entry, regardless of whether they also have implicit access via workspace or org role.

<Card href="https://humansignal.com/goenterprise"> <img style="pointer-events: none; margin-left: 0px; margin-right: 0px;" src="https://docs.humansignal.com/images/badge.svg" alt="Label Studio Enterprise badge"/> <p style="margin-top: 10px; font-size: 14px;"> This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise) </p> </Card> Retrieve the members for a specific project. **Response Fields:** - `implicit_member` (boolean): Indicates if the user is an implicit member. - `true`: User has access via workspace membership or organization role (Administrator/Owner) - `false`: User is an explicit project member (added directly to the project) - `project_role` (string|null): Project-specific role override if assigned, null otherwise **Note:** Users can have both explicit membership AND implicit access. The `implicit_member` field is `false` if the user has an explicit ProjectMember entry, regardless of whether they also have implicit access via workspace or org role.

Authentication

Authorizationstring

The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example:

curl https://label-studio-host/api/projects -H “Authorization: Token [your-token]”

The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example: <br><pre><code class="language-bash">curl https://label-studio-host/api/projects -H "Authorization: Token [your-token]"</code></pre>

Path parameters

idintegerRequired

Query parameters

idsstringOptional

Comma-separated list of user IDs to filter by

implicitbooleanOptional

Include/Exclude implicit project members in the results. If not provided, explicit + implicit members are returned.

last_activity__gtedatetimeOptional

Filter by last activity time (ISO 8601 datetime). Returns users with last activity greater than or equal to this time.

no_annotatorsbooleanOptional

Exclude annotators from the results

orderingstringOptional

Ordering field. Prefix with ”-” for descending order. Allowed fields: id, email, first_name, last_name, username, last_activity, role, date_joined

Note on role ordering: When ordering by “role”, the system uses the effective role:

Project-specific role if assigned (takes precedence)
Organization role if no project role is assigned

Roles are sorted alphabetically by their code: AD (Administrator), AN (Annotator), DI (Disabled), MA (Manager), NO (Not Activated), OW (Owner), RE (Reviewer)

Ordering field. Prefix with "-" for descending order. Allowed fields: id, email, first_name, last_name, username, last_activity, role, date_joined **Note on role ordering:** When ordering by "role", the system uses the effective role: - Project-specific role if assigned (takes precedence) - Organization role if no project role is assigned Roles are sorted alphabetically by their code: AD (Administrator), AN (Annotator), DI (Disabled), MA (Manager), NO (Not Activated), OW (Owner), RE (Reviewer)

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

rolestringOptional

Filter members by role. Accepts single role or comma-separated list of roles.

Format:

Single role: ?role=RE
Multiple roles: ?role=AN,RE (users with ANY of these roles)

Role Codes:

OW = Owner
AD = Administrator
MA = Manager
RE = Reviewer
AN = Annotator

Matching Logic: Returns users who have any of the specified roles either:

As their project-specific role (from project role assignments), OR
As their organization role (if they have no project-specific role override)

Note: Project-specific roles take precedence. If a user has a project role assigned, their organization role is ignored for filtering purposes.

Filter members by role. Accepts single role or comma-separated list of roles. **Format:** - Single role: `?role=RE` - Multiple roles: `?role=AN,RE` (users with ANY of these roles) **Role Codes:** - `OW` = Owner - `AD` = Administrator - `MA` = Manager - `RE` = Reviewer - `AN` = Annotator **Matching Logic:** Returns users who have any of the specified roles either: 1. As their **project-specific role** (from project role assignments), OR 2. As their **organization role** (if they have no project-specific role override) **Note:** Project-specific roles take precedence. If a user has a project role assigned, their organization role is ignored for filtering purposes.

searchstringOptional

Search term for filtering members by name, email, or username

with_deletedbooleanOptional

Include deleted members in the results

Response

countinteger

resultslist of objects

nextstring or nullformat: "uri"

previousstring or nullformat: "uri"

1	from label_studio_sdk import LabelStudio
2
3	client = LabelStudio(
4	api_key="YOUR_API_KEY",
5	)
6	response = client.projects.members.paginated.list(
7	id=1,
8	)
9	for item in response:
10	yield item
11	# alternatively, you can paginate page-by-page
12	for page in response.iter_pages():
13	yield page

1	{
2	"count": 123,
3	"results": [
4	{
5	"active_organization_meta": "string",
6	"avatar": "string",
7	"id": 1,
8	"implicit_member": true,
9	"initials": "?",
10	"last_activity": "2024-01-15T09:30:00Z",
11	"lse_fields": {
12	"email_notification_settings": "string",
13	"invite_expired": "string",
14	"invite_expired_at": "string",
15	"invite_activated": true,
16	"invited_at": "2024-01-15T09:30:00Z",
17	"invited_by": 1,
18	"onboarding_state": "not_started",
19	"social_auth_finished": true,
20	"trial_company": "string",
21	"trial_experience_labeling": "string",
22	"trial_license_enterprise": true,
23	"trial_models_in_production": "string",
24	"trial_role": "annotator"
25	},
26	"organization_membership": {
27	"active": "string",
28	"organization_id": 1,
29	"role": "string"
30	},
31	"pause": "string",
32	"project_role": "string",
33	"username": "string",
34	"org_membership": [
35	{
36	"active": "string",
37	"organization_id": 1,
38	"role": "string"
39	}
40	],
41	"active_organization": 1,
42	"allow_newsletters": true,
43	"custom_hotkeys": null,
44	"date_joined": "2024-01-15T09:30:00Z",
45	"email": "string",
46	"first_name": "string",
47	"last_name": "string",
48	"phone": "string"
49	}
50	],
51	"next": "http://api.example.org/accounts/?page=4",
52	"previous": "http://api.example.org/accounts/?page=2"
53	}