---
search:
  tags:
    - Roles and permissions
    - GET
seo:
  description: >-
    Requires ac:read. The built-in Roles (owner, admin, member) are listed…
    Reference for the GET /organizations/{organizationId}/roles endpoint in the
    Auth API.
sidebar:
  label: List Roles
  badge: GET
title: List Roles
type: openapi-operation
---
Requires ac:read. The built-in Roles (owner, admin, member) are listed with their fixed Grants.

`GET /organizations/{organizationId}/roles`

**Responses**

- `200` — The Roles and their Grants, oldest first.
- `default` — The request failed.

Response example, 200:

```json
[
  {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "builtin": true,
    "grants": {
      "version": 1,
      "statements": [
        {
          "scope": {
            "type": "organization",
            "ids": [
              "497f6eca-6276-4993-bfeb-53cbbbba6f08"
            ],
            "all": true
          },
          "permissions": [
            "string"
          ]
        }
      ]
    },
    "created_at": "2019-08-24T14:15:22Z"
  }
]
```
