---
title: "GET /api/v4/roles"
method: GET
path: "/api/v4/roles"
---

# GET /api/v4/roles

`GET /api/v4/roles`

Get roles list.

## Query parameters

- `with` string
- `page` integer
- `limit` integer

## Response `200`

The request has succeeded.

- union
  - RoleListResponse
    - `_total_items` integer
    - `_page` integer
    - `_page_count` integer
    - `_links` object
    - `_embedded` object
      - `roles` Role[]
        - `id` integer
        - `name` string
        - `rights` UserRights
          - `leads` object
          - `contacts` object
          - `companies` object
          - `tasks` object
          - `mail_access` boolean
          - `catalog_access` boolean
          - `is_admin` boolean
          - `is_free` boolean
          - `is_active` boolean
          - `group_id` integer, nullable
          - `role_id` integer, nullable
          - `status_rights` StatusRight[], nullable
            - `entity_type` string
            - `pipeline_id` integer
            - `status_id` integer
            - `rights` object
        - `_links` object
        - `_embedded` RoleEmbedded
          - `users` object[]
            - `id` integer
  - Problem
    - `title` string
    - `status` integer
    - `detail` string
    - `type` string

---

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