---
title: "Get User roles"
method: GET
path: "/roles"
tags: ["User Roles"]
---

# Get User roles

`GET /roles`

### Get Roles

This endpoint retrieves a list of roles.

#### Response

The response is a JSON object with a `roles` array containing objects with the following properties:

- `id` (string): The ID of the role.
    
- `name` (string): The name of the role.
    
- `level` (string): The level of the role.
    
- `twofa_type` (string): The type of two-factor authentication associated with the role.
    
- `userIds` (array of strings): An array of user IDs associated with the role.

## Response `200`

Successful operation

- object
  - `roles` object[]
    - `id` string
    - `level` string
    - `name` string
    - `twofa_type` string
    - `userIds` string[]

---

[API](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1.md) · [All operations](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/commpeak/dialer-api-v2-0-1/revisions/eacecf960bb6/schema)