---
search:
  tags:
    - administration
    - GET
seo:
  description: >-
    What is returned: Returns complete information about a specific… Reference
    for the GET /administration/roles/{id} endpoint in the Leadtime Public API
    API.
sidebar:
  badge: GET
  label: Get role details
title: Get role details
type: openapi-operation
---
**What is returned:**
Returns complete information about a specific role, including all its permissions and metadata.

**Role details include:**
- Basic information: name, description, icon, type (normal or guest)
- Permission map: complete list of all permissions with their allowed/disallowed status
- Inheritance: parent role ID if permissions are inherited
- Metadata: creation date, last edit date, creator (for custom roles)
- Read-only status: indicates if this is a base role that cannot be modified

**Permission values:**
- true: Permission is explicitly allowed
- false: Permission is explicitly disallowed
- undefined/missing: Permission is inherited from parent role (if parent exists)

**Base roles:**
Base roles (Root, CEO, Team Leader, Staff, Guest) are read-only and cannot be modified. Their permissions are predefined by the system.

**Use cases:**
- Display role details in role management interfaces
- Show permission matrix for a specific role
- Edit role permissions (for custom roles only)
- Understand permission inheritance from parent roles

<Operation source="api-reference" id="rolescontroller-getroledetails" />