CEP com IBGE

Consulta código IBGE com o cep

ViaCEP - Webservice CEP e IBGE gratuitoviacep.com.br

Procurando um webservice gratuito e de alto desempenho para consultar Códigos de Endereçamento Postal (CEP) do Brasil? Utilize o serviço, melhore a qualidade de suas aplicações web e colabore para manter esta base de dados atualizada.

Acessando o webservice de CEP

Para acessar o webservice, um CEP no formato de {8} dígitos deve ser fornecido, por exemplo: "01001000". Após o CEP, deve ser fornecido o tipo de retorno desejado, que deve ser "json", "xml", "piped" ou "querty".

Exemplo de pesquisa por CEP: viacep.com.br/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 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 manipular este "erro" em javascript nos exemplos abaixo.

Formatos de Retorno

Veja exemplos de acesso ao webservice e os diferentes tipos de retorno:

JSON

URL: viacep.com.br/ws/01001000/json/ UNICODE: viacep.com.br/ws/01001000/json/unicode/

    {
      "cep": "01001-000",
      "logradouro": "Praça da Sé",
      "complemento": "lado ímpar",
      "bairro": "Sé",
      "localidade": "São Paulo",
      "uf": "SP",
      "ibge": "3550308",
      "gia": "1004",
      "ddd": "11",
      "siafi": "7107"
    }
            

JSONP

URL: viacep.com.br/ws/01001000/json/?callback=callback_name UNICODE: viacep.com.br/ws/01001000/json/unicode/?callback=callback_name

    callback_name({
      "cep": "01001-000",
      "logradouro": "Praça da Sé",
      "complemento": "lado ímpar",
      "bairro": "Sé",
      "localidade": "São Paulo",
      "uf": "SP",
      "ibge": "3550308",
      "gia": "1004",
      "ddd": "11",
      "siafi": "7107"
    });
            

XML

URL: viacep.com.br/ws/01001000/xml/

    <?xml version="1.0" encoding="UTF-8"?>
    <xmlcep>
        <cep>01001-000</cep>
        <logradouro>Praça da Sé</logradouro>
        <complemento>lado ímpar</complemento>
        <bairro>Sé</bairro>
        <localidade>São Paulo</localidade>
        <uf>SP</uf>
        <ibge>3550308</ibge>
        <gia>1004</gia>
        <ddd>11</ddd>
        <siafi>7107</siafi>
    </xmlcep>
            

PIPED

URL: viacep.com.br/ws/01001000/piped/

    cep:01001-000|logradouro:Praça da Sé|complemento:lado ímpar|bairro:Sé|
    localidade:São Paulo|uf:SP|ibge:3550308|gia:1004|ddd:11|siafi:7107
            

QUERTY

URL: viacep.com.br/ws/01001000/querty/

    cep=01001-000&logradouro=Pra%C3%A7a%20da%20S%C3%A9&complemento=lado%20%C3%ADmpar
    &bairro=S%C3%A9&localidade=S%C3%A3o%20Paulo&uf=SP&ibge=3550308&gia=1004&ddd=11&siafi=7107
            

Origem IBGE: Acessar Site Origem GIA/ICMS (somente SP): Visualizar PDF (Pág.137) Origem DDD: Acessar Site Origem SIAFI: Acessar Site

Exemplos: Auto Preenchimento de Endereço via CEP

Exemplo usando jQuery

Exemplo de acesso ao webservice com a biblioteca jQuery/Json. Preenchimento de endereço via CEP com jQuery

Exemplo em Javascript

Exemplo de acesso ao webservice com Javascript/Json. Preenchimento de endereço via CEP com Javascript

Pesquisa de CEP

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 parâmetros 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 muito 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 parâmentros 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).

Achou um CEP desatualizado?

Acesse o formulário e atualize on-line. Atualizar CEP

Módulos e Pacotes desenvolvidos por Colaboradores

Precisando integrar sua linguagem de programação ou tecnologia com o ViaCEP? Verifique a existência de módulos ou pacotes para facilitar este processo. Módulos e Pacotes