---
title: "List all permissions"
method: GET
path: "/api/v1/permissions"
tags: ["Permissions"]
---

# List all permissions

`GET /api/v1/permissions`

Retrieves a comprehensive, paginated list of all permissions available within the environment. Use this endpoint to view all permission definitions for auditing, role management, or understanding the complete set of available access controls. The response includes pagination tokens to navigate through large sets of permissions efficiently. Each permission object contains the permission name, description, creation time, and last update time. This operation is useful for building permission selection interfaces, auditing permission usage, or understanding the scope of available access controls in your RBAC system.

## Query parameters

- `page_token` string
- `page_size` integer
- `type` 'SCALEKIT' | 'ENVIRONMENT'

## Response `200`

Successfully retrieved the list of permissions. Returns a paginated list of permission objects with metadata and pagination tokens for navigation.

- RolesListPermissionsResponse
  - `next_page_token` string — Token to retrieve next page of results
  - `permissions` 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
  - `prev_page_token` string — Token to retrieve previous page of results
  - `total_size` integer — Total number of permissions available

---

[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)