---
title: "GET /authorization/permissions"
method: GET
path: "/authorization/permissions"
tags: ["Authorization", "Permissions"]
---

# GET /authorization/permissions

`GET /authorization/permissions`

Fetches the list of all REST API permissions

This endpoint requires the permission "authorization.permissions.read".

## Headers

- `Authorization` string, required
- `SplinterProtocolVersion` integer

## Response `200`

Successfully retrieved the list of REST API permissions

- object
  - `data` Permission[]
    - `permission_id` string — Unique identifier for the permission
    - `permission_display_name` string — A human readable name of the permission
    - `permission_description` string — A helpful description of the permission

## Other responses

- `400` — Request was malformed
- `401` — The client is unauthorized

## Changes

- **2021-10-22** `b189e44dea24` — 1 breaking, 3 info
  - the `data/items/` response's property type/format changed from `#/components/schemas/Permission`/`` to `object`/`` for status `200`
  - added the optional property `data/items/permission_description` to the response with the `200` status
  - added the optional property `data/items/permission_display_name` to the response with the `200` status
  - added the optional property `data/items/permission_id` to the response with the `200` status
- **2021-05-13** `f5e618c6f5df` — 1 breaking, 3 warning
  - the `data/items/` response's property type/format changed from `object`/`` to `#/components/schemas/Permission`/`` for status `200`
  - removed the optional property `data/items/permission_description` from the response with the `200` status
  - removed the optional property `data/items/permission_display_name` from the response with the `200` status
  - removed the optional property `data/items/permission_id` from the response with the `200` status

[Change history](https://skmtc.dev/cargill/apis/splinterd-api/changes/authorization/permissions/get.md)

---

[API](https://skmtc.dev/cargill/apis/splinterd-api.md) · [All operations](https://skmtc.dev/cargill/apis/splinterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cargill/splinterd-api/revisions/38a272c24bd9/schema)