Skip to navigation
API ReferenceProjectsMembersPaginated

✨ Get project members paginated

Label Studio Enterprise badge

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.

Authentication

AuthorizationToken

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]"

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.

last_activity__ltedatetimeOptional

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

no_annotatorsbooleanOptional
Exclude annotators from the results
no_view_onlybooleanOptional

Exclude view-only users 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)

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:

  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
tagsstringOptional

Filter members by tags. Use a comma-separated list of tag IDs.

tags_operatorenumOptional

How the tags ids combine: any (at least one tag), all (every tag, the default), none (no selected tag).

Allowed values:
user_typelist of stringsOptional
Multiple values may be separated by commas.
with_deletedbooleanOptional
Include deleted members in the results

Response

countinteger
resultslist of objects
nextstring or nullOptionalformat: "uri"
previousstring or nullOptionalformat: "uri"