API REST gratuita, sem cadastro, sem API key, sem limites. Integre em minutos.
curl https://consultadecep.com/ws/01001000/json/A consulta de CEP é essencial em diversas operações do dia a dia. Veja como integrar.
Preencha endereços automaticamente no checkout. Reduza abandono de carrinho e erros de entrega.
Obtenha dados geográficos precisos para calcular fretes e prazos de entrega com exatidão.
Valide e complete endereços em formulários de cadastro. Menos erros, dados mais limpos.
Complete sua base de dados com cidade, estado, bairro e código IBGE a partir do CEP.
Webservice gratuito de alto desempenho para consulta de Código de Endereçamento Postal (CEP) do Brasil. Basta uma requisição HTTP — sem autenticação, sem cadastro.
Para acessar o webservice, um CEP no formato de 8 dígitos deve ser fornecido. Após o CEP, informe o tipo de retorno desejado: json.
Exemplo de consulta: https://consultadecep.com/ws/01001000/json/
Quando consultado um CEP de formato inválido — por exemplo: "950100100" (9 dígitos), "95010A10" (alfanumérico), "95010 10" (espaço) — o código de retorno será um 400 (Bad Request). Antes de acessar o webservice, valide o formato do CEP e certifique-se que o mesmo possua 8 dígitos numéricos.
Quando consultado um CEP de formato válido, porém inexistente (ex: "99999999"), o retorno conterá um valor de "erro": true. Isso significa que o CEP não foi encontrado na base de dados.
A resposta é retornada em formato JSON. Veja abaixo um exemplo de consulta e a resposta completa:
{
"cep": "01001-000",
"logradouro": "Praça da Sé",
"complemento": "- lado ímpar",
"unidade": "",
"bairro": "Sé",
"localidade": "São Paulo",
"uf": "SP",
"ibge": "3550308",
"gia": "",
"ddd": "",
"siafi": ""
}Existem situações onde o cliente desconhece o CEP do endereço. Para isso, é possível realizar uma pesquisa informando três parâmetros obrigatórios: UF, Cidade e Logradouro. Cidade e Logradouro devem ter no mínimo 3 caracteres.
O resultado é ordenado pela proximidade do nome do logradouro e possui limite máximo de 50 CEPs. Quanto mais específicos os parâmetros, maior a precisão do resultado.
Exemplos de pesquisa por endereço:
// Resposta (array de resultados)
[
{
"cep": "01310-100",
"logradouro": "Avenida Paulista",
"complemento": "- até 610 - lado par",
"bairro": "Bela Vista",
"localidade": "São Paulo",
"uf": "SP",
"ibge": "3550308"
},
...
]Quando a cidade ou logradouro não contiver ao menos 3 caracteres, o retorno será um 400 (Bad Request).
A API é gratuita e sem cadastro, mas para garantir a disponibilidade do serviço para todos, aplicamos um limite de 100 requisições por minuto por IP.
Ao exceder o limite, a API retornará o código 429 (Too Many Requests) com o header Retry-After indicando quantos segundos aguardar antes de tentar novamente.
Cada resposta inclui os headers X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset para que você possa monitorar seu consumo.
Copie e cole no seu projeto.
// Consulta por CEP
const response = await fetch("https://consultadecep.com/ws/01001000/json/");
const data = await response.json();
console.log(data.logradouro); // "Praça da Sé"
console.log(data.localidade); // "São Paulo"
// Consulta por endereço
const busca = await fetch("https://consultadecep.com/ws/SP/São Paulo/Paulista/json/");
const resultados = await busca.json();
resultados.forEach(endereco => {
console.log(`${endereco.cep} - ${endereco.logradouro}`);
});Digite um CEP e veja o resultado em tempo real.
Auto preenchimento de endereço via CEP com código fonte completo.
Utilizamos o eDNE (e-Diretório Nacional de Endereços), a base oficial dos Correios com todos os CEPs do Brasil.
A base é atualizada periodicamente conforme novas versões disponibilizadas pelos Correios, garantindo dados sempre atualizados.
Mais de 1,5 milhão de logradouros, 83 mil bairros e 11 mil localidades em todos os 27 estados brasileiros.