---
title: "Listar tarefas"
method: GET
path: "/tasks"
tags: ["crm-v2-tasks"]
---

# Listar tarefas

`GET /tasks`

Recupera uma lista paginada de tarefas, com filtros para status, tipo e responsável.

## Filtro

Propriedades disponíveis para filtro usando [RDQL](crm-v2-rdql-filtering).

| Propriedade | Tipo | Descrição |
| :--- | :--- | :--- |
| `deal_id` | `String` | Filtra por um ID de negócio específico. |
| `type` | `String` | Filtra pelo tipo da tarefa. |
| `owner_ids` | `String` | Filtra por um ou mais IDs de proprietários (donos). |
| `completed_at` | `DateTime` | Filtra por data e hora de conclusão da tarefa. |
| `due_date` | `DateTime` | Filtra por data e hora de vencimento da tarefa. |
| `status` | `String` | Filtra pelo status da tarefa. |

## Ordenação

Propriedades disponíveis para [ordenação](crm-v2-introduction#ordenação).

* `due_date`
* `deal_id`
* `completed_at`
* `updated_at`

## Query parameters

- `filter` string
- `sort` object
- `page` object
  - `number` integer — Número da página.
  - `size` integer — Tamanho da página.

## Response `200`

OK

- object
  - `data` object[] — Lista de recursos relacionados.
    - `id` string — Identificador único.
    - `name` string — Assunto da tarefa.
    - `description` string — Notas ou descrição adicional da tarefa.
    - `type` 'call' | 'email' | 'meeting' | 'task' | 'lunch' | 'visit' | 'whatsapp' — Tipo da tarefa.
    - `status` 'open' | 'completed' | 'canceled' — Status da tarefa.
    - `due_date` string, date-time — Data limite para conclusão da tarefa.
    - `created_by_id` string — ID do usuário que criou a tarefa.
    - `completed_at` string, date-time — Data em que a tarefa foi concluída.
    - `completed_by_id` string — ID do usuário que concluiu a tarefa.
    - `deal_id` string — ID da negociação associada.
    - `owner_ids` string[] — IDs dos usuários responsáveis pela tarefa.
    - `created_at` string, date-time — Data de criação da tarefa.
    - `updated_at` string, date-time — Data de atualização da tarefa.
  - `links` object — Links de navegação da paginação.
    - `first` string, uri — Link para a primeira página.
    - `prev` string, uri — Link para a página anterior.
    - `self` string, uri — Link para a página atual.
    - `next` string, uri — Link para a próxima página.
    - `last` string, uri — Link para a última página.

## Other responses

- `400` — A requisição está malformada e não consegue ser processada.
- `401` — O token da API está ausente ou inválido.
- `403` — O token não tem permissão para acessar o recurso solicitado.
- `429` — O limite de requisições foi excedido.
- `500` — Internal Server Error

---

[API](https://skmtc.net/rdstation/apis/webhook-service.md) · [All operations](https://skmtc.net/rdstation/apis/webhook-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rdstation/webhook-service/revisions/3867c21388e8/schema)