---
title: "Get Roles"
method: GET
path: "/v1/admin/roles"
tags: ["Admin"]
---

# Get Roles

`GET /v1/admin/roles`

## Query parameters

- `offset` integer — Number of roles to skip.
- `limit` integer — Maximum number of roles to return.
- `sort_by` 'id' | 'name' | 'created'
- `sort_order` 'asc' | 'desc'

## Response `200`

Successful Response

- RolesResponse
  - `object` 'list' — Type of the object.
  - `total` integer, required — Total number of roles.
  - `offset` integer, required — Offset of the roles list.
  - `limit` integer, required — Limit of the roles list.
  - `data` RoleResponse[], required — List of roles.
    - `object` 'role' — Type of the object.
    - `id` integer, required — ID of the role.
    - `name` string, required — Name of the role.
    - `permissions` PermissionType[], required — List of permissions.
    - `limits` Limit[], required — List of limits.
      - `router_id` integer, required — The router ID.
      - `type` 'tpm' | 'tpd' | 'rpm' | 'rpd', required
      - `value` integer, nullable — The limit value.
    - `users` integer, required — Number of users assigned to the role.
    - `created` integer, required — Time of creation, as Unix timestamp.
    - `updated` integer, required — Time of last update, as Unix timestamp.

## Other responses

- `401` — Invalid authentication scheme.<br>Invalid API key.
- `403` — User has no admin rights.<br>Your account has expired. Please contact support to renew your account.
- `422` — Validation Error

---

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