---
title: "Retreive a role"
method: GET
path: "/roles/{id}"
tags: ["Roles"]
---

# Retreive a role

`GET /roles/{id}`

## Request

- Base URL: `https://api-staging.fanheroapi.com`
- URL: `https://api-staging.fanheroapi.com/roles/{id}`
- Auth: API key in header `apiKey`

## Response `200`

Successful resopnse

- RolesDto
  - `id` string, required: Role ID
  - `permissions` PermissionDto[], required: Permissions
    - `id` string, required: Permission ID
    - `name` string, required: Permission name
    - `description` string, required: Permission description
    - `subject` SubjectDto, required
      - `id` string: Subject ID
      - `fields` string[]: Fields
      - `entity` string: Entity identified by this subject
    - `actions` string[], required: The actions that this permission allows to be performed on the subject
  - `name` string, required: Role name
  - `description` string, required: Role description
  - `public` boolean, required: If **True**, this role is available to all user, including those that are not logged it.
  - `default` boolean, required: If **True**, this role is assigned to any newly created organization.

## Other responses

- `404`: Role not found

---

[API](https://skmtc.dev/fanhero/apis/user-management-endpoints.md) - [All operations](https://skmtc.dev/fanhero/apis/user-management-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/fanhero/apis/user-management-endpoints/revisions/3f982670c057?raw)