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

# Listar agendamentos

> GET /appointments: lista os agendamentos da conta, paginada. PII só com customers:read.

Lista os agendamentos da sua conta, paginados. Exige o escopo `appointments:read`.

**page** `number` (default: 1)

Número da página.

**per\_page** `number` (default: 25)

Itens por página (1 a 100). Fora dessa faixa, a API responde `422`.

Com o escopo `customers:read`, cada agendamento traz um bloco `customer` com nome, e-mail e telefone. A resposta vem em `data`, com `links` e `meta`. Os campos estão na [Visão geral](https://developers.qsmarthub.com/referencia.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.