---
title: "List all users in a project"
method: GET
path: "/gdc/projects/{project_id}/users"
tags: ["project-users-management"]
---

# List all users in a project

`GET /gdc/projects/{project_id}/users`

## Request

- Base URL: `https://secure.gooddata.com`
- URL: `https://secure.gooddata.com/gdc/projects/{project_id}/users`
- Auth: none declared

To return users of only a specific status, you can add a `status` parameter.
**Values:** enabled | disabled
**Example:** /gdc/projects/{project-id}/users?status=enabled

## Path parameters

- `project_id` string, required

## Query parameters

- `offset` number
- `limit` number

## Response `200`

_

- UsersTypeProject
  - `users` UserTypeProject[], required
    - `user` object, required
      - `content` UserContent, required
        - `status` 'ENABLED' | 'DISABLED', required
        - `firstname` string
        - `lastname` string
        - `email` string, email: email in valid format
        - `login` string
        - `phonenumber` string
        - `userRoles` string[]: useRoles that will be assigned to updated or new user (previous roles are discarded - there is no merge!)
      - `links` object
        - `self` string, uri: URI of the user's profile
        - `roles` string, uri
        - `permissions` string, uri
        - `projectRelUri` string, uri
        - `invitations` string, uri
        - `projects` string, uri
      - `meta` MetaResponse
        - `title` string, required: Title of this metadata object. Mustn't contain only whitespace characters
        - `category` string: Category of this metadata object
        - `tags` string: List of tags for this metadata object separated by spaces
        - `author` string, uri: URI of the user's profile
        - `created` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss`
        - `contributor` string, uri: URI of the user's profile
        - `updated` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss`
        - `identifier` string: Global identifier of a metadata object
        - `flags` string[]: List of flags specified for this metadata object
        - `summary` string: A short description of this metadata object
        - `uri` string: Link to this metadata object
        - `deprecated` '0' | '1': Flag that the metadata object is deprecated
        - `locked` 0 | 1: Flag that the metadata object is locked
        - `unlisted` 0 | 1: Flag that the metadata object is unlisted
        - `isProduction` 0 | 1: Flag that the metadata object is production
        - `sharedWithSomeone` 0 | 1: Is the linked object shared with someone via ACLs?

---

[API](https://skmtc.dev/gooddata/apis/gooddata-api-documentation.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/revisions/e5dc0ee6ab00?raw)