---
title: "List"
method: GET
path: "/api/v1/iam/roles"
tags: ["Role"]
---

# List

`GET /api/v1/iam/roles`

List all roles for the current user.

## Query parameters

- `page_size` integer — The pageSize field.
- `page_token` string — The pageToken field.

## Response `200`

The ListRolesResponse message contains a list of results and a nextPageToken if applicable.

- C1ApiIamV1ListRolesResponse — The ListRolesResponse message contains a list of results and a nextPageToken if applicable.
  - `list` C1ApiIamV1Role[], nullable — The list of results containing up to X results, where X is the page size defined in the request.
    - `createdAt` string, date-time
    - `deletedAt` string, date-time
    - `displayName` string — The display name of the role.
    - `id` string — The id of the role.
    - `name` string — The internal name of the role.
    - `permissions` string[], nullable — The list of permissions this role has.
    - `serviceRoles` string[], nullable — The list of serviceRoles that this role has.
    - `systemApiOnly` boolean — This Role is intended for API keys usage only, and the user interface may not function as expected.
    - `systemBuiltin` boolean — The system builtin field. If this field is set, the role is not editable.
    - `updatedAt` string, date-time
  - `nextPageToken` string — The nextPageToken is shown for the next page if the number of results is larger than the max page size. The server returns one page of results and the nextPageToken until all results are retreived. To retrieve the next page, use the same request and append a pageToken field with the value of nextPageToken shown on the previous page.

---

[API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/d391405a35d3/schema)