# Buscar Cliente por Documento
`GET /v1/customers`
**Área:** Clientes

**Scopes necessários:** `customers/read`

Busca direta de um único cliente pelo CPF/CNPJ exato, retornando junto o endereço padrão dele.

Diferente de Listar Clientes, esta chamada não devolve lista nem paginação: retorna o objeto do cliente e o endereço em uma única resposta, pronto para preencher um formulário. Quando o documento não está cadastrado, a resposta é 200 com customer e address em null — não é erro.

Case de uso:

_Como checkout próprio, quero consultar o CPF digitado pelo comprador e, se ele já for cliente, preencher nome, e-mail, telefone e endereço automaticamente._

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `lookupDocument` | não | CPF (11) ou CNPJ (14), apenas dígitos - required |

### Resposta 200 — 200

```json
{
  "customer": {
    "customerId": "cus_xxx",
    "name": "Alexandre Souza",
    "document": "11144477735",
    "email": "alexandre@exemplo.com.br",
    "phone": "5511987654321",
    "status": "ACTIVE"
  },
  "address": {
    "zipCode": "01310100",
    "street": "Avenida Paulista",
    "number": "1000",
    "complement": "Sala 5",
    "neighborhood": "Bela Vista",
    "city": "São Paulo",
    "state": "SP",
    "cityCode": "3550308"
  }
}
```

### Resposta 200 — 200 (não encontrado)

```json
{
  "customer": null,
  "address": null
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/get-buscar-cliente-por-documento
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json