---
title: "Get roles for a project"
method: GET
path: "/gdc/projects/{project_id}/roles"
tags: ["project-roles-management"]
---

# Get roles for a project

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

## Request

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

This API returns the list of user roles existing in the project. The user roles are listed by their IDs.
The values for role IDs vary by project.

To get a specific user role only (for example, the Administrator user role or the Viewer user role), use the `identifier` parameter set to the user role identifier, for example:

`.../gdc/projects/{project_id}/roles?identifier=adminRole`

For more information about user roles and their identifiers, see [User Roles](https://help.gooddata.com/display/doc/User+Roles).

## Path parameters

- `project_id` string, required

## Query parameters

- `identifier` string

## Response `200`

_

- ProjectRoles
  - `projectRoles` object, required
    - `roles` string[], required
    - `links` object, required
      - `project` string, required

---

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