GET
/v1/cep/{cep}Consulta de CEP & Coordenadas Prediais
Retorna os dados cadastrais oficiais do logradouro (bairro, cidade, UF, código IBGE, DDD) acompanhados da latitude e longitude do imóvel.
Parâmetros da Requisição
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| cep | Path (string) | Sim | CEP com 8 dígitos, com ou sem hífen (ex: 01310-100 ou 01310100). |
| numero | Query (string) | Opcional | Número predial do imóvel para obter a coordenada métrica exata de porta. |
Exemplos de Código
curl -s "https://api.geocep.api.br/v1/cep/01310-100?numero=2644"🌐 Modo público: Gratuito até 100 requisições/hora por IP sem cadastro.HTTPS / TLS 1.3
Exemplo de Resposta (200 OK)
{
"status": "success",
"data": {
"cep": "01310-100",
"tipoLogradouro": "Avenida",
"logradouro": "Paulista",
"enderecoCompleto": "Avenida Paulista, 2644",
"numero": "2644",
"bairro": "Bela Vista",
"cidade": "São Paulo",
"uf": "SP",
"codigoIbge": "3550308",
"ddd": "11",
"coordenadas": {
"latitude": -23.554893,
"longitude": -46.663839,
"precisao": "numero_exato",
"fonte": "ibge_cnefe"
}
}
}