---
title: "List every organization permission that exists"
method: GET
path: "/organizations_permissions"
tags: ["organization_roles"]
---

# List every organization permission that exists

`GET /organizations_permissions`

## Request

- Base URL: `https://api.planvortex.com/v1.0.0`
- URL: `https://api.planvortex.com/v1.0.0/organizations_permissions`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (client credentials, token URL `https://api.planvortex.com/v1.0.0/oauth/token`)

Returns the catalogue of organization permissions accepted in the `permissions` property of a role. Static: it does not depend on the caller or on any organization. Only a valid token is required.

## Response `200`

Successful operation

- OrganizationsRolesPermissionList
  - `permissions` string[]

## Other responses

- `400`: The request failed. The body carries the PlanVortex error code in `code`: | Code | Meaning | | --- | --- | | `501` | Invalid authorization token | | `518` | User or application deleted | | `522` | Invalid token: expired |
- `401`: Insufficient permissions. The body carries error code `520` with the permissions that were required.
- `500`: Unhandled error by the server (PlanVortex error code `500`).

---

[API](https://skmtc.dev/planvortex/apis/planvortex-api.md) · [All operations](https://skmtc.dev/planvortex/apis/planvortex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/planvortex/apis/planvortex-api/revisions/abedbbc1cd52?raw)