# API CEP

## Buscar um CEP

<mark style="color:blue;">`GET`</mark> `https://cep.awesomeapi.com.br/:format/:cep`

Retorna o endereço do CEP\
Ex.: **<https://cep.awesomeapi.com.br/json/01001000>**

#### Path Parameters

| Name                                  | Type      | Description                                                      |
| ------------------------------------- | --------- | ---------------------------------------------------------------- |
| format                                | string    | Formato de resposta JSON (padrão), XML                           |
| cep<mark style="color:red;">\*</mark> | string(8) | Apenas os 8 números do CEP com o "0" do inicio exemplo: 01001000 |

{% tabs %}
{% tab title="200 CEP encontrado" %}

```json
{
    "cep": "01001000",
    "address_type": "Praça",
    "address_name": "da Sé",
    "address": "Praça da Sé",
    "state": "SP",
    "district": "Sé",
    "lat": "-23.5502784",
    "lng": "-46.6342179",
    "city": "São Paulo",
    "city_ibge": "3550308",
    "ddd": "11"
}
```

{% endtab %}

{% tab title="400 CEP inválido" %}

```
{
    status: 400,
    code: "invalid",
    message: "CEP invalido"
}
```

{% endtab %}

{% tab title="404 CEP não encontrado" %}

```javascript
{
    status: 404,
    code: "not_found",
    message: "O CEP 00000000 nao foi encontrado"
}
```

{% endtab %}
{% endtabs %}