---
title: "Get all roles"
method: GET
path: "/roles"
tags: ["Roles"]
---

# Get all roles

`GET /roles`

Returns all the roles within the company.

## Query parameters

- `start` integer
- `limit` integer

## Response `200`

Get all roles

- object
  - `success` boolean — If the response is successful or not
  - `data` object[] — The array of roles
    - `parent_role_id` integer, nullable — The ID of the parent role
    - `name` string — The name of the role
    - `id` integer — The ID of the role
    - `active_flag` boolean — Whether the role is active or not
    - `assignment_count` string — The number of users assigned to this role
    - `sub_role_count` string — The number of sub-roles
    - `level` integer — The level of role in the role hierarchy
  - `additional_data` object — The additional data in the role list
    - `pagination` object — The pagination details in the role list
      - `start` integer — Pagination start
      - `limit` integer — Items shown per page
      - `more_items_in_collection` boolean — Whether there are more list items in the collection than displayed

---

[API](https://skmtc.net/pipedrive/apis/pipedrive-api-v1.md) · [All operations](https://skmtc.net/pipedrive/apis/pipedrive-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipedrive/pipedrive-api-v1/versions/bf863a979545/schema)