> For the complete documentation index, see [llms.txt](https://apidoc.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.toplojas.com.br/clientes/detalhes-do-cliente.md).

# Detalhes do Cliente

Retorna os **dados completos** de um cliente específico, identificado pelo seu **Código**.

```
GET /clientes/{Codigo}/
```

O `{Codigo}` é o código do cliente, obtido na [listagem de clientes](/clientes/listar-clientes.md).

## 📥 Exemplo de requisição

```bash
curl -X GET "https://api.toplojas.com.br/clientes/679695/" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]"
```

## 📤 O que é retornado

Os detalhes de um cliente incluem, entre outros:

| Campo              | Descrição                                                        |
| ------------------ | ---------------------------------------------------------------- |
| `Codigo`           | Código interno do cliente                                        |
| `IsPessoa`         | Tipo de pessoa: `F` (Física) ou `J` (Jurídica)                   |
| `Nome_RazaoSocial` | Nome completo ou razão social do cliente                         |
| `CPF_CNPJ`         | CPF ou CNPJ (pode vir formatado ou não)                          |
| `RG_IE`            | RG ou IE (pode vir formatado ou não)                             |
| `DataNascimento`   | Data de nascimento (`Ano-Mês-Dia`)                               |
| `ObsStaff`         | Observação interna, visível apenas para a administração          |
| `Email`            | E-mail do cliente                                                |
| `Telefone01/02/03` | Telefones de contato                                             |
| `Endereco`         | Endereço do cliente (estado, cidade, bairro, logradouro, CEP...) |

Exemplo completo de um cliente retornado:

```json
{
  "Codigo": "679695",
  "IsPessoa": "F",
  "Nome_RazaoSocial": "Paloma Macetko",
  "CPF_CNPJ": "999.999.99-99",
  "RG_IE": "",
  "DataNascimento": "2024-01-01",
  "ObsStaff": "",
  "Email": "suporte2@web4business.com.br",
  "Telefone01": "(47) 11111111",
  "Telefone03": "(47) 22222222",
  "Telefone02": "(47) 33333333",
  "Endereco": {
    "End_Estado": "SC",
    "End_Cidade": "Brusque",
    "End_Bairro": "Centro",
    "End_Endereco": "Rua Central",
    "End_Numero": "99",
    "End_Complemento": "",
    "End_CEP": "88350-000"
  }
}
```

{% hint style="info" %}
Consulte a descrição de cada campo retornado na referência:

{% embed url="<https://api.toplojas.com.br/doc/#/Clientes>" %}
{% endhint %}