---
title: "List Roles"
method: GET
path: "/tenants/{tenant_id}/roles"
tags: ["Users"]
---

# List Roles

`GET /tenants/{tenant_id}/roles`

Returns a list of roles.

---

Roles are returned sorted in ascending order with custom roles listed first if any exist, then ordered alphabetically by name.

For more on custom roles, see our [Help Center](https://help.aurorasolar.com/hc/en-us/articles/11459813328787).

## Path parameters

- `tenant_id` string, uuid, required

## Response `200`

Roles successfully retrieved.

- object
  - `roles` object[]
    - `id` string, uuid — Unique ID identifying the role.
    - `name` string — Name of the role.
    - `custom` boolean — Whether or not the role is custom for the tenant. Global roles are derived from previously existing user levels and present for all tenants.
    - `scope` string — Represents the global level of access for managing projects, users, and teams in your organization and partners.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

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