# Clientes

URL: https://staging.pagpolar.com/docs/referencia/clientes

> Liste e consulte clientes.

Objeto principal: **[Cliente](/docs/referencia/entidades/cliente)**.

| Campo | Tipo | Obrigatório | Nulo | Descrição |
| --- | --- | --- | --- | --- |
| `id` | texto (uuid) | não | não | Exemplo: `e6f7a8b9-c0d1-4e2f-3a4b-5c6d7e8f9a0b`. |
| `name` | texto | não | não | Exemplo: `Maria Souza`. |
| `email` | texto (email) | não | não | Exemplo: `maria@exemplo.com`. |
| `document` | texto | não | sim | Mascarado: CPF vira ***.XXX.***-**, CNPJ vira **.XXX.***/****-**. null se o cliente não tem documento cadastrado. Exemplo: `***.456.***-**`. |
| `phone` | texto | não | sim | Mascarado: mantém só os últimos 4 dígitos (****XXXX). null se o cliente não tem telefone cadastrado. Exemplo: `****4321`. |
| `is_active` | booleano | não | não | Exemplo: `true`. |
| `created_at` | texto (date-time) | não | não | Exemplo: `2026-01-05T08:00:00.000Z`. |