---
title: "Get all roles in an organisation"
method: GET
path: "/v2/organisations/{organisation_id}/roles"
tags: ["Gateway GRPC"]
---

# Get all roles in an organisation

`GET /v2/organisations/{organisation_id}/roles`

## Request

- Base URL: `https://api.cautio.in` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cautio.in/v2/organisations/{organisation_id}/roles`
- Auth: HTTP bearer

## Path parameters

- `organisation_id` string, required

## Query parameters

- `search` string
- `page` number
- `limit` number

## Response `200`

- GetOrganisationRolesResponseDto
  - `data` GetOrganisationRolesResponseDataDto, required
    - `organisation_id` string, required: Organisation ID
    - `items` RoleDetailsDto[], required: List of role details
      - `id` string, required: Role ID
      - `name` string, required: Role Name
      - `role_type` string, required: Role Type
      - `description` string, required: Role Description
      - `user_count` number, required: Number of Users with this role
      - `edit_policy` 'STANDARD' | 'SYSTEM_ONLY', required: Role edit policy
    - `pagination` PaginationResponseDto, required
      - `page` number, required: Current page number
      - `limit` number, required: Number of items per page
      - `total` number, required: Total number of items
      - `has_next` boolean, required: Whether there is a next page
      - `has_prev` boolean, required: Whether there is a previous page

---

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