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

# GET /cep-lookup/:cep

> Converta qualquer CEP em endereço completo instantaneamente: logradouro, bairro, cidade e estado em uma única chamada de API.

## Endpoint

```
GET https://api.bunny.build/api/v1/cep-lookup/:cep
```

## Autenticação

| Header      | Obrigatório | Valor                        |
| ----------- | ----------- | ---------------------------- |
| `X-API-Key` | Sim         | Sua chave de API (`bun_...`) |

## Visão geral

Converta qualquer CEP brasileiro em endereço completo instantaneamente. A API de CEP da Bunny retorna logradouro, bairro, cidade e estado para qualquer CEP de 8 dígitos válido, sem necessidade de formatação prévia.

## Casos de uso

* Preenchimento automático de formulários de endereço no checkout
* Validação de destinos de entrega
* Enriquecimento de cadastros de clientes com dados de localização
* Construção de mapas de área de entrega

## Detalhes

Remova o hífen antes de passar o CEP. Aceita `01310100` ou `01310-100`. Ambos funcionam. Retorna campos nulos para CEPs que cobrem um município inteiro sem logradouro específico.

## Parâmetros de rota

| Parâmetro | Tipo   | Obrigatório | Descrição                                         |
| --------- | ------ | ----------- | ------------------------------------------------- |
| `cep`     | string | Sim         | CEP brasileiro, somente dígitos (ex.: `01310100`) |

## Resposta

### 200 OK

| Campo        | Tipo           | Descrição          |
| ------------ | -------------- | ------------------ |
| `cep`        | string         | O CEP consultado   |
| `street`     | string \| null | Nome do logradouro |
| `complement` | string \| null | Complemento        |
| `district`   | string \| null | Bairro             |
| `city`       | string \| null | Cidade             |
| `state`      | string \| null | UF (ex.: `SP`)     |

**Exemplo**

```json theme={null}
{
  "cep": "01310100",
  "street": "Avenida Paulista",
  "complement": "de 1 a 610 - lado par",
  "district": "Bela Vista",
  "city": "São Paulo",
  "state": "SP"
}
```

### 401 Unauthorized

```json theme={null}
{
  "detail": "Missing API key. Include X-API-Key header."
}
```

### 402 Payment Required

```json theme={null}
{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}
```

### 404 Not Found

CEP não encontrado.

```json theme={null}
{
  "detail": "CEP not found"
}
```

### 422 Unprocessable Entity

Formato de CEP inválido.

```json theme={null}
{
  "detail": "Invalid CEP format"
}
```

### 429 Too Many Requests

```json theme={null}
{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}
```

## Exemplo cURL

```bash theme={null}
curl https://api.bunny.build/api/v1/cep-lookup/01310100 \
  -H "X-API-Key: bun_sua_chave_api"
```