---
title: "List all users in a Data Warehouse instance"
method: GET
path: "/gdc/datawarehouse/instances/{instanceId}/users"
tags: ["datawarehouse"]
---

# List all users in a Data Warehouse instance

`GET /gdc/datawarehouse/instances/{instanceId}/users`

## Request

- Base URL: `https://secure.gooddata.com`
- URL: `https://secure.gooddata.com/gdc/datawarehouse/instances/{instanceId}/users`
- Auth: none declared

You must be an `admin` to perform this procedure.<br/> For more information about user roles, see [Data Warehouse User Roles](https://help.gooddata.com/display/doc/Data+Warehouse+User+Roles).<br/> Poll to get execution status.

## Query parameters

- `offset` string
- `limit` integer

## Response `200`

List of all users in the instance

- Users
  - `users` object, required: List of Data Warehouse users
    - `items` UserResponse[], required
      - `user` UserCommon, required
        - `role` string, required: The user role. Can be `admin` (can manage the instance and users within in it), `dataAdmin` (can run queries; cannot manage users), or `readOnly` (can only access the instance in read-only mode; cannot make any changes in the instance). For more information about user roles, see [Data Warehouse User Roles](https://help.gooddata.com/display/doc/Data+Warehouse+User+Roles).
        - `profile` string, uri: URI of the user's profile
        - `login` string, email: GoodData login of the user. **NOTE:** Specify either `profile` or `login`, not both.
        - `links` SelfParentLinks: Self and parent links
          - `self` string, uri, required: Self link
          - `parent` string, uri, required: Parent link
    - `links` SelfParentLinks, required: Self and parent links
      - `self` string, uri, required: Self link
      - `parent` string, uri, required: Parent link
    - `paging` Paging, required: Paging structure containing link to the next page.
      - `next` string, uri, nullable: Uri to next page, when such page exists.

## Other responses

- `404`: Instance has not been found.

---

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