# API de CEP

> Endereço de qualquer CEP do Brasil, com código IBGE do município e coordenadas.

Base: `https://ceps.apizen.com.br/v1`. CEPs do CNEFE (IBGE) e dos endereços da Receita Federal: 1.244.338 CEPs, cada um com o código IBGE do município e um ponto no mapa.

## GET /cep/{cep}

O CEP com 8 dígitos, com ou sem hífen.

**cURL**

```bash
curl https://ceps.apizen.com.br/v1/cep/01001000 \
  -H "Authorization: Bearer $CEPS_API_KEY"
```

**JavaScript**

```javascript
const res = await fetch("https://ceps.apizen.com.br/v1/cep/01001000", {
  headers: { Authorization: `Bearer ${process.env.CEPS_API_KEY}` },
});
const dados = await res.json();
```

**Python**

```python
import os, requests

res = requests.get(
    "https://ceps.apizen.com.br/v1/cep/01001000",
    headers={"Authorization": f"Bearer {os.environ['CEPS_API_KEY']}"},
)
dados = res.json()
```

**Go**

```go
req, _ := http.NewRequest("GET", "https://ceps.apizen.com.br/v1/cep/01001000", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("CEPS_API_KEY"))
res, err := http.DefaultClient.Do(req)
```

```json
{
  "cep": "01001000",
  "logradouro": "Praca da Se",
  "bairro": "Centro",
  "municipio": { "codigo_ibge": "3550308", "nome": "São Paulo" },
  "uf": "SP",
  "localizacao": { "latitude": -23.549153, "longitude": -46.63359 },
  "enderecos": 6999,
  "estabelecimentos": 449,
  "fonte": "receita"
}
```

| Campo | Tipo | |
|---|---|---|
| `cep` | texto | 8 dígitos |
| `logradouro` | texto ou null | |
| `bairro` | texto ou null | |
| `municipio` | objeto | `codigo_ibge` (7 dígitos) e `nome` |
| `uf` | texto | |
| `localizacao` | objeto ou null | `latitude` e `longitude` (WGS 84), um ponto do CEP no mapa |
| `enderecos` | número ou null | endereços do CNEFE nesse CEP |
| `estabelecimentos` | número ou null | estabelecimentos com CNPJ nesse CEP |
| `fonte` | texto | `cnefe`, `receita` ou `cnefe+receita` |

## GET /base

O mês dos dados e quantos CEPs há, no total e por fonte: `mes`, `versao`, `ceps`, `ceps_receita`, `ceps_cnefe`.
