Retorno da API

Base

Esse é o formato de resultado mais comum.

{
  "bairro": "Centro",
  "cidade": "S\u00e3o Paulo",
  "logradouro": "Rua Doutor Itapura de Miranda",
  "estado_info": {
    "area_km2": "248.222,801",
    "codigo_ibge": "35",
    "nome": "S\u00e3o Paulo"
  },
  "cep": "01022060",
  "cidade_info": {
    "area_km2": "1521,101",
    "codigo_ibge": "3550308"
  },
  "estado": "SP"
}

Logradouro com complemento

Alguns logradouros tem um complemento, que é colocado no campo complemento.

{
  "complemento": "lado par",
  "bairro": "S\u00e9",
  "cidade": "S\u00e3o Paulo",
  "logradouro": "Pra\u00e7a da S\u00e9",
  "estado_info": {
    "area_km2": "248.222,801",
    "codigo_ibge": "35",
    "nome": "S\u00e3o Paulo"
  },
  "cep": "01001001",
  "cidade_info": {
    "area_km2": "1521,101",
    "codigo_ibge": "3550308"
  },
  "estado": "SP"
}

CEP da cidade

Cidades menores tem apenas um CEP.

{
  "cidade": "Areal",
  "estado_info": {
    "area_km2": "43.780,172",
    "codigo_ibge": "33",
    "nome": "Rio de Janeiro"
  },
  "cep": "25845000",
  "cidade_info": {
    "area_km2": "110,919",
    "codigo_ibge": "3300225"
  },
  "estado": "RJ"
}

CEPs especiais

CEPs com final 9xx são um produto dos Correios. Eles tem um endereco e um cliente ao invés de um logradouro.

{
  "bairro": "Jardim Santa Carolina (Nova Veneza)",
  "cidade": "Sumar\u00e9",
  "endereco": "Rua Alfredo Dumont Villares, 155",
  "estado_info": {
    "area_km2": "248.222,801",
    "codigo_ibge": "35",
    "nome": "S\u00e3o Paulo"
  },
  "cep": "13178902",
  "cidade_info": {
    "area_km2": "153,502",
    "codigo_ibge": "3552403"
  },
  "estado": "SP",
  "cliente": "Villares Metals S.A."
}