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

# Get roles

`GET /roles`

Returns an array with one or more roles

## Query parameters

- `offset` integer
- `limit` integer
- `order` 'ASC' | 'DESC'

## Response `200`

successful operation

- Role[]
  - `id` integer
  - `name` string — name is unique
  - `description` string — optional description
  - `created_at` integer — creation time as unix timestamp in milliseconds
  - `updated_at` integer — last update time as unix timestamp in milliseconds
  - `users` string[] — list of usernames associated with this group
  - `admins` string[] — list of admins usernames associated with this group

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error
- `default` — Unexpected Error

---

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