---
title: "Fetches a list of roles"
method: GET
path: "/authorization/roles"
tags: ["Roles", "Permissions", "RBAC", "Authorization"]
---

# Fetches a list of roles

`GET /authorization/roles`

This endpoint can be used to view all of the available roles configured
for the node.  These roles control access to various permissions in the
system.

This endpoint requires the permission "authorization.rbac.read".

## Query parameters

- `offset` integer
- `limit` integer

## Headers

- `Authorization` string, required
- `SplinterProtocolVersion` integer

## Response `200`

Successfully retrieved the requested list of roles

- object
  - `data` Role[]
    - `role_id` string — Unique identifier for the role
    - `display_name` string — A human readable name of the role.
    - `permissions` string[] — An array of permissions included with this role.
  - `paging` Paging
    - `current` string
    - `offset` integer
    - `limit` integer
    - `total` integer
    - `first` string
    - `prev` string
    - `next` string
    - `last` string

## Other responses

- `400` — Request was malformed
- `401` — The client is unauthorized
- `500` — An internal server error occurred

---

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