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

# List permissions

`GET /permissions`

## Request

- Base URL: `https://api-staging.fanheroapi.com`
- URL: `https://api-staging.fanheroapi.com/permissions`
- Auth: API key in header `apiKey`

## Query parameters

- `page` number
- `pageSize` number
- `direction` 'ASC' | 'DESC'
- `field` 'name'

## Headers

- `organization` string, required

## Response `200`

Successful resopnse

- object: A paginated list of Permissions
  - `page` integer: The current page
  - `pageSize` integer: The number of objects per page
  - `total` integer: The total number of objects in the response
  - `pageCount` integer: The total number of pages
  - `pageNumberIsGood` boolean: Page number is valid.
  - `hasPreviousPage` boolean: There is a previous page.
  - `hasNextPage` boolean: There is a next page.
  - `isFirstPage` boolean: This is the first page.
  - `isLastPage` boolean: This is the last page.
  - `rows` PermissionDto[]: **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

---

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