> ## 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 anotações

> Lista as anotações internas de um contato (lead), aninhadas sob o lead.

Uma **anotação** (`ContactNote`) é uma nota interna registrada no histórico de um contato. Todos os endpoints são aninhados sob o lead (`/api/v1/leads/{id}/notes`).

## Autenticação

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

Aceita `limit` (1–100, padrão 25) e `offset`.

<RequestExample>
  ```bash cURL theme={null}
  curl "https://crm.vistum.com.br/api/v1/leads/cnt_cmnl5abc123/notes" \
    -H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 — OK theme={null}
  {
    "data": [
      { "id": "note_1", "body": "Cliente pediu retorno na terça.", "authorName": "Carlos", "createdAt": "2026-07-20T14:00:00.000Z" }
    ],
    "pagination": { "total": 1, "limit": 25, "offset": 0, "hasMore": false }
  }
  ```
</ResponseExample>

<Note>
  O DTO expõe o autor apenas por **nome** (`authorName`), nunca por ID.
</Note>