---
search:
  tags:
    - Roles and permissions
    - GET
seo:
  description: >-
    Every Permission a Grant can give, and for each scope the Permissions it can
    hold, for example… Reference for the GET /permissions endpoint in the Auth
    API.
sidebar:
  label: Get the Permission catalog
  badge: GET
title: Get the Permission catalog
type: openapi-operation
---
Every Permission a Grant can give, and for each scope the Permissions it can hold, for example to build a Role editor. The catalog is the same for every organization.

`GET /permissions`

**Responses**

- `200` — The catalog.
- `default` — The request failed.

Response example, 200:

```json
{
  "resources": [
    {
      "resource": "string",
      "label": "string",
      "operations": [
        "string"
      ]
    }
  ],
  "scopes": [
    {
      "type": "organization",
      "description": "string",
      "all": true,
      "permissions": [
        {
          "permission": "string",
          "label": "string",
          "description": "string",
          "requires_all": true
        }
      ]
    }
  ]
}
```
