---
title: "Retrieve permission details"
method: GET
path: "/api/v1/permissions/{permission_name}"
tags: ["Permissions"]
---

# Retrieve permission details

`GET /api/v1/permissions/{permission_name}`

Retrieves complete information for a specific permission by its unique name identifier. Use this endpoint to view permission details including description, creation time, and last update time. Provide the permission name in the path parameter following the format 'action:resource' (for example, 'read:documents'). This operation is useful for auditing permission definitions, understanding permission purposes, or verifying permission existence before assignment. Returns the complete permission object with all metadata and system-generated timestamps.

## Path parameters

- `permission_name` string, required

## Response `200`

Successfully retrieved permission details. Returns the complete permission object including name, description, creation time, and update time.

- RolesGetPermissionResponse
  - `permission` RolesPermission
    - `create_time` string, date-time
    - `description` string
    - `id` string
    - `is_scalekit_permission` boolean — Indicates whether this permission is predefined by Scalekit
    - `name` string
    - `update_time` string, date-time

---

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