> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vistum.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar tarefas

> Lista tarefas e follow-ups do workspace com filtros por contato, negócio, status, responsável e vencimento.

Uma **tarefa** (`Task`) é um follow-up com prazo, opcionalmente vinculado a um contato e/ou negócio e atribuído a um membro.

## Autenticação

<ParamField header="Authorization" type="string" required>
  `Bearer vg_live_<sua_chave>` — API Key com escopo `tasks:read`
</ParamField>

## Parâmetros de query

| Parâmetro          | Tipo         | Descrição                                     |
| ------------------ | ------------ | --------------------------------------------- |
| `contactId`        | string       | Tarefas de um contato.                        |
| `cardId`           | string       | Tarefas de um negócio.                        |
| `status`           | string       | `pending` ou `done`.                          |
| `assignedTo`       | string       | ID do usuário responsável.                    |
| `dueAfter`         | string (ISO) | Vencimento a partir desta data.               |
| `dueBefore`        | string (ISO) | Vencimento até esta data.                     |
| `sort`             | string       | `dueAt` (padrão), `createdAt` ou `updatedAt`. |
| `order`            | string       | `asc` (padrão) ou `desc`.                     |
| `limit` / `offset` | number       | Paginação (1–100, padrão 25).                 |

<RequestExample>
  ```bash cURL theme={null}
  curl "https://crm.vistum.com.br/api/v1/tasks?status=pending&sort=dueAt&order=asc" \
    -H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 — OK theme={null}
  {
    "data": [
      {
        "id": "task_1",
        "title": "Ligar para retomar proposta",
        "type": "call",
        "dueDate": "2026-07-22T13:00:00.000Z",
        "status": "pending",
        "contactId": "cnt_cmnl5abc123",
        "cardId": "card_def456ghi",
        "assignedTo": { "id": "usr_carlos", "name": "Carlos Atendente" },
        "createdAt": "2026-07-21T10:00:00.000Z"
      }
    ],
    "pagination": { "total": 1, "limit": 25, "offset": 0, "hasMore": false }
  }
  ```
</ResponseExample>