CEP

Consulta de CEP

Endereços com dados oficiais dos Correios (e-DNE). Gratuita, sem cadastro e com API aberta.

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

Exemplos

Documentação da API

Uma requisição GET, sem autenticação. A resposta segue o formato do ViaCEP, então clientes existentes funcionam trocando apenas a URL base.

Endpoint

GET https://cep.databanx.com.br/ws/{cep}/json
{cep}
8 dígitos, com ou sem hífen: 01001000 ou 01001-000.
Resposta
application/json em UTF-8, compatível com o formato do ViaCEP.
Limite
100 requisições por minuto por IP. Acima disso a API responde 429.
Cache
O header X-Cache indica HIT (servido do cache) ou MISS (consultado na base).

Exemplos

Terminal
curl https://cep.databanx.com.br/ws/01001000/json

Campos da resposta

Todos os campos são strings. Campos sem informação vêm como "".

Campo Descrição Exemplo
cep CEP formatado com hífen. 01001-000
logradouro Tipo e nome do logradouro. Vazio em CEP único de cidade. Praça da Sé
complemento Trecho ou lado do logradouro coberto pelo CEP. lado ímpar
unidade Nome do grande usuário ou da unidade dos Correios, quando o CEP é exclusivo. ""
bairro Bairro. Sé
localidade Município. São Paulo
uf Sigla da unidade federativa. SP
estado Nome da unidade federativa. São Paulo
regiao Região geográfica. Sudeste
ibge Código IBGE do município, 7 dígitos. 3550308
gia Sempre vazio. Mantido só por compatibilidade com o ViaCEP. ""
ddd DDD telefônico da localidade. 11
siafi Código SIAFI do município (Tesouro Nacional). 7107

O campo gia (Guia de Informação e Apuração do ICMS, SP) não consta na base dos Correios e por isso vem sempre vazio.

Município de um CEP

Para quem só precisa do código IBGE, inclusive quando o CEP digitado não é de um endereço, como o "CEP geral" de uma cidade que tem CEP por rua.

GET https://cep.databanx.com.br/ws/{cep}/municipio
Resposta
cep, localidade, uf, estado, regiao, ibge, ddd, siafi e origem.
origem
"cep" quando o CEP é um endereço; "faixa" quando só a faixa de CEPs do município o contém. Ex.: 46100-000 → Brumado/BA, IBGE 2904605, "faixa".
Não encontrado
404 {"erro": true} quando o CEP não está na faixa de nenhum município. A rota /json continua respondendo 404 para CEPs que não são endereços, como o ViaCEP.

Códigos de status

"erro": true marca CEP inválido ou inexistente. Falhas temporárias (429 e 503) trazem só "mensagem": trate-as pelo status HTTP.

Status Significado Corpo
200 CEP encontrado. Objeto com os campos acima.
400 Formato inválido: o CEP não tem 8 dígitos. {"erro": true, "mensagem": "CEP inválido: informe 8 dígitos"}
404 CEP não encontrado na base. {"erro": true}
429 Limite excedido: mais de 100 requisições por minuto do mesmo IP. {"mensagem": "Limite de requisições excedido"}
503 Serviço temporariamente indisponível ou base ainda não carregada. Tente de novo em instantes. {"mensagem": "Serviço temporariamente indisponível"} ou {"mensagem": "Base de CEPs ainda não carregada"}