API CEP

Base de CEP IBGE atualizado periódicamente

Buscar um CEP

GET 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*	string(8)	Apenas os 8 números do CEP com o "0" do inicio exemplo: 01001000

200 CEP encontrado

{
    "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"
}

400 CEP inválido

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

404 CEP não encontrado

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