# Cliente

URL: https://staging.pagpolar.com/docs/referencia/entidades/cliente

> Quem comprou. Documento e telefone chegam mascarados.

Quem comprou. Documento e telefone chegam mascarados.

## Onde aparece

* [`GET /customers`](/docs/referencia/clientes/list-customers)
* [`GET /customers/{id}`](/docs/referencia/clientes/get-customer)

Também aparece dentro de [Venda](/docs/referencia/entidades/venda), [Assinatura](/docs/referencia/entidades/assinatura) e [Reembolso](/docs/referencia/entidades/reembolso), no campo `customer`.

## Campos

Campos anuláveis chegam com `null`. Campos com opções fixas listam todos os valores.

| 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`. |