Base dos Correios — atualizada periodicamente

Consulte qualquer CEP do Brasil

API REST gratuita, sem cadastro, sem API key, sem limites. Integre em minutos.

curl https://consultadecep.com/ws/01001000/json/

Sem cadastroSem API keySem limitesCORSHTTPS

1,5M+

Logradouros

83 mil

Bairros

11 mil

Localidades

Estados

Documentação

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.

Acessando o webservice

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/

Validação do CEP

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.

Formato de retorno

A resposta é retornada em formato JSON. Veja abaixo um exemplo de consulta e a resposta completa:

GET/ws/01001000/json/

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

Pesquisa de CEP por endereço

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:

https://consultadecep.com/ws/RS/Porto Alegre/Domingos/json/—Busca por "Domingos" em Porto Alegre/RS

https://consultadecep.com/ws/SP/São Paulo/Paulista/json/—Busca por "Paulista" em São Paulo/SP

https://consultadecep.com/ws/SP/Ribeirão Preto/Nove de Julho/json/—Busca por "Nove de Julho" em Ribeirão Preto/SP

GET/ws/{uf}/{cidade}/{logradouro}/json/

// 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).

Exemplos de uso

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}`);
});