---
title: "Retrieve a Role"
method: GET
path: "/api/v1/roles/{id}"
tags: ["Roles"]
---

# Retrieve a Role

`GET /api/v1/roles/{id}`

Permissions needed: ACCESS_ADMINISTRATION_SETTINGS
Returns a Role entity

## Parameters

- `#/paths/~1api~1v1~1sales/delete/parameters/0` — unresolved $ref

## Response `200`

successful operation

- object
  - `data` object
    - `id` integer
    - `clinic_id` integer, nullable — The clinic this role belongs to. Null for enterprise (group-level) roles.
    - `group_id` integer, nullable — The enterprise group this role belongs to. Null for clinic-local roles.
    - `title` string
    - `immutable` boolean
    - `permissions_categories` object — Keys are permissions groups ids.

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `429` — unresolved $ref

---

[API](https://skmtc.net/digitail/apis/digitail-api.md) · [All operations](https://skmtc.net/digitail/apis/digitail-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitail/digitail-api/revisions/bd9694db5fce/schema)