---
title: "Lista de tarefas"
method: GET
path: "/api/v4/tasks"
---

# Lista de tarefas

`GET /api/v4/tasks`

## Request body

- object
  - `page` integer — Número de página
  - `limit` integer — O número de entidades retornadas na resposta de uma solicitação (limite – 250)
  - `filter` object
    - `responsible_user_id` object
      - integer[] — Filtro pelo ID do usuário responsável pela empresa. Pode ser passado um único ID ou um array de IDs.
    - `is_completed` integer — Filtrar por status da tarefa. 1 – completa, 0 – aberta
    - `task_type` object
      - integer[] — Filtrar pelo ID do tipo de tarefa. Pode ser passado um único ID ou um array de IDs.
    - `entity_type` 'leads' | 'contacts' | 'companies' — Filtrar pelo tipo de entidade à qual a tarefa está vinculada.
    - `entity_id` object
      - integer[] — Filtrar pelo ID da entidade à qual a tarefa está vinculada. Para usar o filtro, o valor deve ser passado em filter[entity_type]. Pode ser passado um único ID ou um array de IDs.
    - `id` object — Valores disponíveis para ordenação: asc, desc.
      - integer[] — Filtrar pelo ID da tarefa. Pode ser passado um único ID ou um array de IDs.
    - `updated_at` object — Filtrar pela última edição da tarefa. Um carimbo de data/hora pode ser passado, nesse caso, as tarefas editadas após o valor do carimbo de data/hora serão retornadas.
      - `from` integer — Filtrar pela última edição da tarefa. Um carimbo de data/hora pode ser passado.
      - `to` integer — Filtrar pela última edição da tarefa. Um carimbo de data/hora pode ser passado.
  - `order` object
    - `complete_till` string — Valores disponíveis para ordenação: asc, desc.
    - `created_at` string — Valores disponíveis para ordenação: asc, desc.
    - `id` string — Valores disponíveis para ordenação: asc, desc.

## Response `200`

200

- object
  - `_page` integer
  - `_links` object
    - `self` object
      - `href` string
    - `next` object
      - `href` string
  - `_embedded` object
    - `tasks` object[]
      - `id` integer
      - `created_by` integer
      - `updated_by` integer
      - `created_at` integer
      - `updated_at` integer
      - `responsible_user_id` integer
      - `group_id` integer
      - `entity_id` integer
      - `entity_type` string
      - `duration` integer
      - `is_completed` boolean
      - `task_type_id` integer
      - `text` string
      - `result` unknown[]
        - unknown
      - `complete_till` integer
      - `account_id` integer
      - `_links` object
        - `self` object
          - `href` string

## Other responses

- `401` — 401

---

[API](https://skmtc.net/kommo/apis/referencias-de-api-da-kommo.md) · [All operations](https://skmtc.net/kommo/apis/referencias-de-api-da-kommo/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kommo/referencias-de-api-da-kommo/versions/98fdf05c2f5b/schema)