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

# List Roles by Tenant

`GET /tenants/{tenant_id}/roles`

This GET method is used to retrieve the list of Roles available within a specific tenant.

## Path parameters

- `tenant_id` string, required

## Response `200`

Success

- RoleListResponse
  - `total_count` integer, required — Total number of roles available in the specific tenant
  - `roles` RoleDetails[], required — List of roles available in specific tenant
    - `id` string, required — ID of the Role. This is an auto generated and unique in the CoreStack system
    - `tenant_id` string — Tenant Id for the Role
    - `name` string, required — Name of the role. This is unique in the CoreStack system for a specific tenant
    - `status` string, required — Status of the Role
    - `access` string[], required — List of access the role can perform in the tenant
    - `users` integer, required — Count of users having the role attached under a tenant
    - `description` string, required — Description of the role
    - `created_at` string, required — Date and time of role creation
    - `category` string, required — Category of the specific role. Either default or custom
    - `policies` object — List of policy available for a role

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.dev/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/revisions/bf2cdf20826d/schema)