---
title: "Lista de usuários"
method: GET
path: "/api/v4/users"
---

# Lista de usuários

`GET /api/v4/users`

## Request

- Base URL: `https://subdomain.kommo.com`
- URL: `https://subdomain.kommo.com/api/v4/users`
- Auth: OAuth 2

Este método permite obter os dados do usuário na conta pelo ID do usuário.

## Request body

- object
  - `with` string: Este parâmetro aceita uma string que pode consistir em vários valores separados por vírgulas. Você pode encontrar os parâmetros ‘with’ na tabela.
  - `page` integer: Página de exemplo
  - `limit` integer: Número de entidades retornadas na resposta de uma solicitação (limite – 250).

## Response `200`

200

- object
  - `_total_items` integer
  - `_page` integer
  - `_page_count` integer
  - `_links` object
    - `self` object
      - `href` string
  - `_embedded` object
    - `users` object[]
      - `id` integer
      - `name` string
      - `email` string
      - `lang` string
      - `rights` object
        - `leads` object
          - `view` string
          - `edit` string
          - `add` string
          - `delete` string
          - `export` string
        - `contacts` object
          - `view` string
          - `edit` string
          - `add` string
          - `delete` string
          - `export` string
        - `companies` object
          - `view` string
          - `edit` string
          - `add` string
          - `delete` string
          - `export` string
        - `tasks` object
          - `edit` string
          - `delete` string
        - `mail_access` boolean
        - `catalog_access` boolean
        - `status_rights` object[]
          - `entity_type` string
          - `pipeline_id` integer
          - `status_id` integer
          - `rights` object
            - `view` string
            - `edit` string
            - `delete` string
        - `is_admin` boolean
        - `is_free` boolean
        - `is_active` boolean
        - `group_id` unknown
        - `role_id` unknown
      - `_links` object
        - `self` object
          - `href` string
      - `_embedded` object
        - `roles` object[]
          - `id` integer
          - `name` string
          - `_links` object
            - `self` object
              - …
        - `groups` object[]
          - `id` integer
          - `name` string

## Other responses

- `401`: 401
- `403`: 403

---

[API](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo.md) - [All operations](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/llms.txt) - [OpenAPI document](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/revisions/55101699dddb?raw)