---
title: "Get the list of roles in an application."
method: GET
path: "/roles"
---

# Get the list of roles in an application.

`GET /roles`

## Query parameters

- `api-version` string, required

## Response `200`

Success

- RoleCollection — The paged results of roles.
  - `value` Role[], required — The collection of roles.
    - `id` string — Unique ID of the role.
    - `displayName` string — Display name of the role.
  - `nextLink` string — URL to get the next page of roles.

## Other responses

- `default` — An error response received from the IoT Central Service.

---

[API](https://skmtc.net/azure/apis/iotcentral-iotcentral.md) · [All operations](https://skmtc.net/azure/apis/iotcentral-iotcentral/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/iotcentral-iotcentral/revisions/565d8813cbd3/schema)