Consulte CEPs de todo o Brasil
Webservice gratuito de alto desempenho para consulta de Código de Endere?amento Postal (CEP) do Brasil.
Para acessar o webservice, um CEP no formato de
{8} dígitos deve ser fornecido,
exemplo: "01001000".
Após o CEP, deve ser fornecido o tipo de retorno desejado,
que deve ser
"json" ou
"xml".
Exemplo de consulta de CEP:
viacep.com.br/ws/01001000/json/
Quando consultado um CEP de formato inválido, exemplo: "950100100" (9 dígitos), "95010A10" (alfanumérico), "95010 10" (espa?o), o código de retorno da consulta 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. Exemplo de como validar o formato do CEP em javascript está disponível nos exemplos abaixo.
Quando consultado um CEP de formato válido, porém inexistente, por exemplo: "99999999", o retorno conterá um valor de "erro" igual a "true". Isso significa que o CEP consultado n?o foi encontrado na base de dados. Veja como tratar este "erro" em javascript nos exemplos abaixo.
Veja exemplos de acesso ao webservice e os diferentes tipos de retorno:
{
"cep": "01001-000",
"logradouro": "Pra?a da Sé",
"complemento": "lado ímpar",
"unidade": "",
"bairro": "Sé",
"localidade": "S?o Paulo",
"uf": "SP",
"estado": "S?o Paulo",
"regiao": "Sudeste",
"ibge": "3550308",
"gia": "1004",
"ddd": "11",
"siafi": "7107"
}
callback_name({
"cep": "01001-000",
"logradouro": "Pra?a da Sé",
"complemento": "lado ímpar",
"unidade": "",
"bairro": "Sé",
"localidade": "S?o Paulo",
"uf": "SP",
"estado": "S?o Paulo",
"regiao": "Sudeste",
"ibge": "3550308",
"gia": "1004",
"ddd": "11",
"siafi": "7107"
});
<?xml version="1.0" encoding="UTF-8"?>
<xmlcep>
<cep>01001-000</cep>
<logradouro>Praça da Sé</logradouro>
<complemento>lado ímpar</complemento>
<unidade></unidade>
<bairro>Sé</bairro>
<localidade>São Paulo</localidade>
<uf>SP</uf>
<estado>São Paulo</estado>
<regiao>Sudeste</regiao>
<ibge>3550308</ibge>
<gia>1004</gia>
<ddd>11</ddd>
<siafi>7107</siafi>
</xmlcep>
Origem IBGE:
Acessar Site
Origem GIA/ICMS (somente SP):
Visualizar PDF (Pág.137)
Origem DDD:
Acessar Site
Origem SIAFI:
Acessar Site
Exemplo de acesso ao webservice utilizando jQuery.
Preenchimento de endere?o via CEP com jQuery
Exemplo de acesso ao webservice com Javascript.
Preenchimento de endere?o via CEP com Javascript
Existem necessidades, por exemplo um cadastramento online onde o cliente desconhece o CEP da sua rua e será necessário realizar uma pesquisa para verificar a existência de um CEP que corresponda ao endere?o. Para consultar um CEP na base de dados s?o necessários três parametros obrigatórios (UF, Cidade e Logradouro), sendo que para Cidade e Logradouro também é obrigatório um número mínimo de três caracteres a fim de evitar resultados extremamente abrangentes.
Identico a consulta por CEP, na pesquisa por endere?o também é necessário informar o formato do retorno que deve ser "json" ou "xml". O resultado será ordenado pela proximidade do nome do logradouro e possui limite máximo de 50 (cinquenta) CEPs. Desta forma, quanto mais específico os paramentros de entrada maior será a precis?o do resultado.
Exemplos de pesquisa por endere?o:
viacep.com.br/ws/RS/Porto Alegre/Domingos/json/
viacep.com.br/ws/RS/Porto Alegre/Domingos Jose/json/
viacep.com.br/ws/RS/Porto Alegre/Domingos+Jose/json/
Os exemplos acima demonstram diferentes formar de pesquisar pelas ocorrências "Domingos" e "José" na cidade de "Porto Algre/RS". Quando o nome da cidade ou do logradouro n?o contiver ao menos três caracteres o código de retorno será um 400 (Bad Request).
Acesse o formulário abaixo para atualizar online.
Atualizar CEP
Precisando integrar sua linguagem de programa??o com o ViaCEP?
Verifique a existência de módulos ou pacotes para facilitar seu processo.
Módulos e Pacotes
