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

# Get Roles

`GET /governance/roles`

Gets all roles

## Query parameters

- `limit` integer, nullable
- `roles` string[], nullable
- `insights` string[], nullable
- `instance_ids` string[], nullable
- `sort_key` string, nullable
- `sort_order` string, nullable
- `search` string, nullable
- `navigationSource` string, nullable
- `page` integer — Page number
- `size` integer — Page size

## Response `200`

Successful Response

- PageGovernanceRoleResponse
  - `items` GovernanceRoleResponse[], required
    - `role_name` string, required
    - `total_cost` number, required
    - `max_cost` number, required
    - `num_of_query_groups` string, required
    - `insights` string[], nullable
    - `avg_cost` number, required
    - `instance_id` integer, nullable
    - `num_of_queries` string, required
    - `num_of_adhoc_queries` string, required
  - `total` integer, nullable, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable

## Other responses

- `400` — Not supported for public user
- `403` — Not supported for public user
- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/aab3fe5c9f05/schema)