Documentação

    API de CEP com geolocalização, busca reversa, autocomplete, CEPs próximos e compatibilidade ViaCEP.

    Sobre

    A API CEP permite consultar endereços brasileiros de forma completa e enriquecida. Além da consulta direta por CEP, a API oferece busca reversa por endereço, autocomplete, busca por locais especiais (empresas, órgãos, prédios), CEPs próximos por coordenada ou a partir de outro CEP, listagem de cidades e bairros e consulta por código IBGE.

    Todos os endpoints usam GET, retornam JSON, exigem autenticação Bearer Token e suportam CORS.

    Autenticação

    Todas as requisições exigem o header Authorization usando o padrão Bearer Token.

    Seu token é gerado automaticamente após a confirmação de pagamento do Plano. Ele fica disponível no seu Painel.

    Header obrigatório em todas as requisições:
    Authorization: Bearer SEU_TOKEN
    bash
    curl -X GET "https://api.apicep.com.br/cep/01001000" \
  -H "Authorization: Bearer SEU_TOKEN"
    ⚠️ Nunca compartilhe seu token publicamente ou exponha no front-end. Use-o apenas em requisições server-side.

    Início rápido

    Faça sua primeira consulta em segundos: informe o CEP no endpoint e receba o endereço completo com geolocalização em JSON.

    GET https://api.apicep.com.br/cep/01001000
    json
    {
  "cep": "01001-000",
  "cepNumerico": "01001000",
  "tipoLogradouro": "Praça",
  "logradouro": "da Sé",
  "endereco": "Praça da Sé",
  "complemento": "- lado ímpar",
  "local": null,
  "bairro": "Sé",
  "cidade": "São Paulo",
  "uf": "SP",
  "estado": "São Paulo",
  "codigoIbge": "3550308",
  "codigoIbgeUf": "35",
  "idCidade": 9668,
  "cepCidade": null,
  "latitude": "-23.5503099",
  "longitude": "-46.6342009"
}

    1. Consultar CEP

    Consulta os dados completos de endereço a partir de um CEP, incluindo geolocalização.

    GET https://api.apicep.com.br/cep/{cep}

    Também aceita via query string:

    GET https://api.apicep.com.br/cep?cep={cep}
    bash
    curl -X GET "https://api.apicep.com.br/cep/01001000" \
  -H "Authorization: Bearer SEU_TOKEN"

    Campos retornados

    cepCEP formatado com hífen
    cepNumericoCEP somente com números
    tipoLogradouroTipo do logradouro: Rua, Avenida, Praça…
    logradouroNome do logradouro
    enderecoEndereço completo montado
    complementoComplemento do CEP, quando houver
    localNome de local especial: empresa, prédio, órgão, instituição
    bairroBairro
    cidadeCidade
    ufEstado em sigla
    estadoNome do estado
    codigoIbgeCódigo IBGE da cidade
    codigoIbgeUfCódigo IBGE da UF
    idCidadeID interno da cidade na base
    cepCidadeCEP geral da cidade, quando existir
    latitudeLatitude do CEP, quando disponível
    longitudeLongitude do CEP, quando disponível

    2. CEP completo / enriquecido

    Retorna os dados do CEP com campos extras: país, região, tipo do CEP e indicação se possui geolocalização.

    GET https://api.apicep.com.br/cep/{cep}/completo

    Também aceita:

    GET https://api.apicep.com.br/cep/{cep}?completo=true
    json
    {
  "cep": "01001-000",
  "cepNumerico": "01001000",
  "tipoLogradouro": "Praça",
  "logradouro": "da Sé",
  "endereco": "Praça da Sé",
  "complemento": "- lado ímpar",
  "local": null,
  "bairro": "Sé",
  "cidade": "São Paulo",
  "idCidade": 9668,
  "cepCidade": "01000-000",
  "uf": "SP",
  "estado": "São Paulo",
  "codigoIbge": "3550308",
  "codigoIbgeUf": "35",
  "ddd": "11",
  "latitude": "-23.5503099",
  "longitude": "-46.6342009",
  "pais": "Brasil",
  "regiao": "Sudeste",
  "tipoCep": "logradouro",
  "temGeolocalizacao": true
}

    Campos extras

    paisPaís do endereço
    regiaoRegião do Brasil conforme a UF
    tipoCepTipo inferido: logradouro, local_especial, cidade ou indefinido
    temGeolocalizacaoIndica se o CEP possui latitude e longitude

    3. Padrão ViaCEP

    Retorna o endereço em formato compatível com o padrão ViaCEP. Ideal para migrar integrações já existentes.

    GET https://api.apicep.com.br/cep/{cep}/viacep

    Também aceita:

    GET https://api.apicep.com.br/cep/{cep}?formato=viacep
    json
    {
  "cep": "01001-000",
  "logradouro": "Praça da Sé",
  "complemento": "- lado ímpar",
  "bairro": "Sé",
  "localidade": "São Paulo",
  "uf": "SP",
  "ibge": "3550308"
}

    Este formato é útil para substituir integrações existentes com o ViaCEP com o mínimo de alteração no código — basta trocar a URL e adicionar o header Authorization.

    4. Geolocalização por CEP

    Retorna apenas latitude e longitude de um CEP.

    GET https://api.apicep.com.br/cep/{cep}/geo

    Também aceita:

    GET https://api.apicep.com.br/cep/geo?cep={cep}
    json
    {
  "cep": "01001-000",
  "cepNumerico": "01001000",
  "latitude": "-23.5503099",
  "longitude": "-46.6342009"
}

    5. Buscar CEP por endereço

    Busca CEPs informando UF, cidade e logradouro. Também pesquisa no campo local, permitindo encontrar CEPs de empresas, órgãos, universidades e prédios.

    GET https://api.apicep.com.br/cep/endereco/{UF}/{cidade}/{logradouro}

    Também aceita via query string:

    GET https://api.apicep.com.br/cep/endereco?uf={UF}&cidade={cidade}&logradouro={logradouro}
    ufObrigatório

    Sigla da UF (2 letras)

    cidadeObrigatório

    Nome da cidade. Mínimo 3 caracteres, máximo 120

    logradouroObrigatório

    Nome do logradouro. Mínimo 3 caracteres, máximo 120. Pesquisa também no campo local

    limit

    Quantidade de resultados

    Padrão: 50Máx: 100
    offset

    Paginação

    Padrão: 0
    bash
    curl -X GET "https://api.apicep.com.br/cep/endereco/SP/Sao%20Paulo/Paulista?limit=10" \
  -H "Authorization: Bearer SEU_TOKEN"

    Exemplo de retorno

    json
    {
  "total": 124,
  "limit": 10,
  "offset": 0,
  "resultados": [
    {
      "cep": "01310-100",
      "tipoLogradouro": "Avenida",
      "logradouro": "Paulista",
      "endereco": "Avenida Paulista",
      "complemento": "- até 610 - lado par",
      "local": null,
      "bairro": "Bela Vista",
      "cidade": "São Paulo",
      "uf": "SP",
      "codigoIbge": "3550308",
      "ddd": "11",
      "latitude": "-23.5614552",
      "longitude": "-46.6558819"
    }
  ]
}

    6. Busca geral / autocomplete

    Busca por termo livre em logradouro, local especial e bairro. Útil para campos de busca, autocomplete, CRM, checkout e sistemas internos.

    GET https://api.apicep.com.br/cep/busca?q={termo}

    Também aceita:

    GET https://api.apicep.com.br/cep?q={termo}
    qObrigatório

    Termo de busca. Mínimo 3, máximo 120 caracteres

    uf

    Filtra por UF (2 letras)

    cidade

    Filtra por cidade. Mínimo 2 caracteres

    limit

    Quantidade de resultados

    Padrão: 20Máx: 100
    offset

    Paginação

    Padrão: 0
    bash
    curl -X GET "https://api.apicep.com.br/cep/busca?q=Serasa&uf=SP&cidade=Sao%20Paulo&limit=10" \
  -H "Authorization: Bearer SEU_TOKEN"

    Exemplo de retorno

    A busca também encontra locais especiais como empresas, órgãos públicos, universidades e prédios cadastrados pelos Correios.

    json
    {
  "total": 3,
  "limit": 10,
  "offset": 0,
  "resultados": [
    {
      "cep": "06460-040",
      "tipoLogradouro": "Alameda",
      "logradouro": "Mamoré",
      "endereco": "Alameda Mamoré, 989",
      "complemento": null,
      "local": "Serasa Experian",
      "bairro": "Alphaville Industrial",
      "cidade": "Barueri",
      "uf": "SP",
      "codigoIbge": "3505708",
      "ddd": "11",
      "latitude": "-23.4988",
      "longitude": "-46.8456"
    }
  ]
}

    7. Próximos por latitude/longitude

    Retorna CEPs próximos a uma coordenada geográfica, ordenados por distância.

    GET https://api.apicep.com.br/cep/proximos?lat={lat}&lng={lng}

    Também aceita:

    GET https://api.apicep.com.br/cep/proximos/{latitude}/{longitude}
    latObrigatório

    Latitude

    lngObrigatório

    Longitude

    raio

    Raio em quilômetros

    Padrão: 2Máx: 50
    limit

    Quantidade de resultados

    Padrão: 10Máx: 100
    offset

    Paginação

    Padrão: 0
    bash
    curl -X GET "https://api.apicep.com.br/cep/proximos?lat=-23.5676&lng=-46.6492&raio=2&limit=10" \
  -H "Authorization: Bearer SEU_TOKEN"

    Cada item inclui o campo extra distanciaKm:

    json
    {
  "latitude": -23.5676,
  "longitude": -46.6492,
  "raioKm": 2,
  "limit": 10,
  "offset": 0,
  "resultados": [
    {
      "cep": "01311-000",
      "logradouro": "Paulista",
      "endereco": "Avenida Paulista",
      "bairro": "Bela Vista",
      "cidade": "São Paulo",
      "uf": "SP",
      "latitude": "-23.5676249",
      "longitude": "-46.6492632",
      "distanciaKm": 0.007
    }
  ]
}

    8. Próximos a partir de um CEP

    Retorna CEPs próximos a um CEP de origem. Por padrão restringe à mesma cidade do CEP pesquisado, evitando falsos positivos por coordenadas inconsistentes.

    GET https://api.apicep.com.br/cep/proximos/{cep}

    Também aceita:

    GET https://api.apicep.com.br/cep/proximos?cep={cep}
    raio

    Raio em quilômetros

    Padrão: 2Máx: 50
    limit

    Quantidade de resultados

    Padrão: 10Máx: 100
    offset

    Paginação

    Padrão: 0
    mesmaCidade

    Restringe à mesma cidade do CEP de origem. Aceita: true/1/sim/s/yes ou false/0/nao/n/no. Use false para qualquer cidade no raio

    Padrão: true
    bash
    # Padrão (apenas mesma cidade)
curl -X GET "https://api.apicep.com.br/cep/proximos/01001000?raio=2&limit=10" \
  -H "Authorization: Bearer SEU_TOKEN"

# Permitindo qualquer cidade no raio
curl -X GET "https://api.apicep.com.br/cep/proximos/01001000?raio=2&limit=10&mesmaCidade=false" \
  -H "Authorization: Bearer SEU_TOKEN"

    9. Listar cidades por UF

    GET https://api.apicep.com.br/cep/cidades/{UF}

    Também aceita:

    GET https://api.apicep.com.br/cep/cidades?uf={UF}
    bash
    curl -X GET "https://api.apicep.com.br/cep/cidades/SP" \
  -H "Authorization: Bearer SEU_TOKEN"
    json
    [
  {
    "idCidade": 8853,
    "cidade": "Adamantina",
    "uf": "SP",
    "estado": "São Paulo",
    "cepCidade": null,
    "codigoIbge": "3500105"
  }
]

    10. Listar bairros por cidade

    GET https://api.apicep.com.br/cep/bairros/{UF}/{cidade}

    Também aceita:

    GET https://api.apicep.com.br/cep/bairros?uf={UF}&cidade={cidade}

    O parâmetro cidade aceita correspondência parcial (mínimo 2 caracteres).

    bash
    curl -X GET "https://api.apicep.com.br/cep/bairros/SP/Sao%20Paulo" \
  -H "Authorization: Bearer SEU_TOKEN"
    json
    [
  {
    "idBairro": 29401,
    "bairro": "Aclimação",
    "idCidade": 9668,
    "cidade": "São Paulo",
    "uf": "SP"
  }
]

    11. Cidade por código IBGE

    Consulta os dados de uma cidade pelo código IBGE (6 a 10 dígitos).

    GET https://api.apicep.com.br/cep/ibge/{codigoIbge}

    Também aceita via query string (qualquer um dos dois nomes):

    GET https://api.apicep.com.br/cep/ibge?codigoIbge={codigoIbge}
    GET https://api.apicep.com.br/cep/ibge?codigo={codigoIbge}
    bash
    curl -X GET "https://api.apicep.com.br/cep/ibge/3550308" \
  -H "Authorization: Bearer SEU_TOKEN"
    json
    {
  "idCidade": 9668,
  "cidade": "São Paulo",
  "uf": "SP",
  "estado": "São Paulo",
  "cepCidade": null,
  "codigoIbge": "3550308"
}

    Endereço Inteligente

    Conjunto de endpoints para validar, corrigir, normalizar, pontuar e localizar endereços brasileiros usando a base de CEPs da API. Ideal para formulários de cadastro, checkout, CRM, ERP, logística e antifraude.

    Todos os endpoints abaixo também aceitam o prefixo alternativo /cep/endereco/... com o mesmo comportamento.

    12. Validar endereço

    Valida se os dados informados (CEP, UF, cidade, bairro, logradouro) são compatíveis com a base. Ideal para formulários, checkout, CRM e ERP.

    GET https://api.apicep.com.br/endereco/validar

    Também aceita:

    GET https://api.apicep.com.br/cep/endereco/validar
    cepObrigatório

    CEP com ou sem hífen

    uf

    UF esperada do endereço

    cidade

    Cidade informada pelo usuário

    bairro

    Bairro informado pelo usuário

    logradouro

    Logradouro informado pelo usuário

    bash
    curl -X GET "https://api.apicep.com.br/endereco/validar?cep=01001000&cidade=Sao%20Paulo&uf=SP&bairro=Se" \
  -H "Authorization: Bearer SEU_TOKEN"
    json
    {
  "valido": true,
  "confianca": 100,
  "classificacao": "excelente",
  "mensagem": "Endereço compatível com a base.",
  "original": {
    "cep": "01001000",
    "uf": "SP",
    "cidade": "Sao Paulo",
    "bairro": "Se"
  },
  "corrigido": {
    "cep": "01001-000",
    "cepNumerico": "01001000",
    "tipoLogradouro": "Praça",
    "logradouro": "da Sé",
    "endereco": "Praça da Sé",
    "complemento": "- lado ímpar",
    "local": null,
    "bairro": "Sé",
    "cidade": "São Paulo",
    "uf": "SP",
    "estado": "São Paulo",
    "codigoIbge": "3550308",
    "codigoIbgeUf": "35",
    "idCidade": 9668,
    "cepCidade": null,
    "latitude": "-23.5503099",
    "longitude": "-46.6342009"
  },
  "comparacoes": {
    "uf": true,
    "cidade": true,
    "bairro": true
  },
  "problemas": [],
  "sugestoes": []
}

    13. Autocomplete de endereço

    Retorna sugestões de endereço em tempo real conforme o usuário digita. Busca por logradouro, local especial e bairro, priorizando logradouros mais diretos.

    GET https://api.apicep.com.br/endereco/autocomplete

    Também aceita:

    GET https://api.apicep.com.br/cep/endereco/autocomplete
    qObrigatório

    Termo pesquisado, mínimo de 3 caracteres

    uf

    Filtra por UF

    cidade

    Filtra por cidade

    limit

    Quantidade de resultados

    Padrão: 10Máx: 50
    offset

    Paginação

    Padrão: 0
    bash
    curl -X GET "https://api.apicep.com.br/endereco/autocomplete?q=av%20paulist&uf=SP&cidade=Sao%20Paulo&limit=10" \
  -H "Authorization: Bearer SEU_TOKEN"
    json
    [
  {
    "label": "Avenida Paulista - até 610 - lado par, Bela Vista, São Paulo/SP",
    "cep": "01310-000",
    "cepNumerico": "01310000",
    "endereco": "Avenida Paulista",
    "logradouro": "Paulista",
    "tipoLogradouro": "Avenida",
    "complemento": "- até 610 - lado par",
    "local": null,
    "bairro": "Bela Vista",
    "cidade": "São Paulo",
    "uf": "SP",
    "latitude": "-23.5674731",
    "longitude": "-46.6491264"
  },
  {
    "label": "Avenida Paulista - de 612 a 1510 - lado par, Bela Vista, São Paulo/SP",
    "cep": "01310-100",
    "cepNumerico": "01310100",
    "endereco": "Avenida Paulista",
    "logradouro": "Paulista",
    "tipoLogradouro": "Avenida",
    "complemento": "- de 612 a 1510 - lado par",
    "local": null,
    "bairro": "Bela Vista",
    "cidade": "São Paulo",
    "uf": "SP",
    "latitude": "-23.5674637",
    "longitude": "-46.6491379"
  }
]

    14. Normalizar endereço

    Recebe dados de endereço digitados pelo usuário e retorna a versão padronizada da base. Útil para limpar cadastros, corrigir acentos e padronizar cidade/UF/bairro.

    GET https://api.apicep.com.br/endereco/normalizar

    Também aceita:

    GET https://api.apicep.com.br/cep/endereco/normalizar
    cep

    CEP com ou sem hífen

    texto

    Texto livre do endereço

    q

    Alternativa ao parâmetro texto

    uf

    UF informada

    cidade

    Cidade informada

    bairro

    Bairro informado

    logradouro

    Logradouro informado

    ℹ️ Ao menos um dos grupos deve ser informado: cep, ou texto/q, ou uf + cidade + logradouro.

    Exemplo com CEP:

    bash
    curl -X GET "https://api.apicep.com.br/endereco/normalizar?cep=01001000&logradouro=praca%20da%20se&cidade=sao%20paulo&uf=sp" \
  -H "Authorization: Bearer SEU_TOKEN"

    Exemplo com texto livre:

    bash
    curl -X GET "https://api.apicep.com.br/endereco/normalizar?texto=praca%20da%20se%20sao%20paulo%20sp" \
  -H "Authorization: Bearer SEU_TOKEN"
    json
    {
  "encontrado": true,
  "confianca": 100,
  "origem": "cep",
  "mensagem": "Endereço normalizado com sucesso.",
  "original": {
    "cep": "01001000",
    "uf": "sp",
    "cidade": "sao paulo",
    "logradouro": "praca da se"
  },
  "normalizado": {
    "cep": "01001-000",
    "cepNumerico": "01001000",
    "tipoLogradouro": "Praça",
    "logradouro": "da Sé",
    "endereco": "Praça da Sé",
    "complemento": "- lado ímpar",
    "local": null,
    "bairro": "Sé",
    "cidade": "São Paulo",
    "uf": "SP",
    "estado": "São Paulo",
    "codigoIbge": "3550308",
    "codigoIbgeUf": "35",
    "idCidade": 9668,
    "cepCidade": null,
    "latitude": "-23.5503099",
    "longitude": "-46.6342009"
  }
}

    15. Score de qualidade

    Analisa a qualidade do endereço informado e retorna uma nota de 0 a 100. Útil para identificar cadastros incompletos, divergentes ou de baixa qualidade.

    GET https://api.apicep.com.br/endereco/score

    Também aceita:

    GET https://api.apicep.com.br/cep/endereco/score
    cep

    CEP com ou sem hífen

    uf

    UF informada

    cidade

    Cidade informada

    bairro

    Bairro informado

    logradouro

    Logradouro informado

    bash
    curl -X GET "https://api.apicep.com.br/endereco/score?cep=01001000&cidade=Sao%20Paulo&uf=SP&bairro=Se" \
  -H "Authorization: Bearer SEU_TOKEN"
    json
    {
  "score": 100,
  "classificacao": "excelente",
  "valido": true,
  "problemas": [],
  "sugestoes": [],
  "original": {
    "cep": "01001000",
    "uf": "SP",
    "cidade": "Sao Paulo",
    "bairro": "Se"
  },
  "corrigido": {
    "cep": "01001-000",
    "cepNumerico": "01001000",
    "tipoLogradouro": "Praça",
    "logradouro": "da Sé",
    "endereco": "Praça da Sé",
    "complemento": "- lado ímpar",
    "local": null,
    "bairro": "Sé",
    "cidade": "São Paulo",
    "uf": "SP",
    "estado": "São Paulo",
    "codigoIbge": "3550308",
    "codigoIbgeUf": "35",
    "idCidade": 9668,
    "cepCidade": null,
    "latitude": "-23.5503099",
    "longitude": "-46.6342009"
  }
}

    Classificações possíveis:

    ClassificaçãoFaixa
    excelente90 a 100
    bom70 a 89
    regular50 a 69
    ruim0 a 49

    16. Geocodificação reversa

    Encontra o endereço mais provável a partir de uma latitude e longitude. Útil para aplicativos, logística, mapas, delivery, check-in e atendimento em campo.

    GET https://api.apicep.com.br/endereco/reverso

    Também aceita:

    GET https://api.apicep.com.br/endereco/reverso/{latitude}/{longitude}
    GET https://api.apicep.com.br/cep/endereco/reverso
    latObrigatório

    Latitude

    lngObrigatório

    Longitude

    raio

    Raio de busca em quilômetros

    Padrão: 1Máx: 50
    bash
    curl -X GET "https://api.apicep.com.br/endereco/reverso?lat=-23.5503&lng=-46.6342&raio=1" \
  -H "Authorization: Bearer SEU_TOKEN"
    json
    {
  "latitude": -23.5503,
  "longitude": -46.6342,
  "raioKm": 1,
  "limit": 1,
  "offset": 0,
  "resultado": {
    "cep": "01001-000",
    "cepNumerico": "01001000",
    "tipoLogradouro": "Praça",
    "logradouro": "da Sé",
    "endereco": "Praça da Sé",
    "complemento": "- lado ímpar",
    "local": null,
    "bairro": "Sé",
    "cidade": "São Paulo",
    "uf": "SP",
    "estado": "São Paulo",
    "codigoIbge": "3550308",
    "codigoIbgeUf": "35",
    "idCidade": 9668,
    "cepCidade": null,
    "latitude": "-23.5503099",
    "longitude": "-46.6342009",
    "distanciaKm": 0.0011
  }
}

    Parâmetros gerais

    ParâmetroOnde usarDescrição
    limitBusca, endereço, próximosLimita a quantidade de resultados. Máximo 100
    offsetBusca, endereço, próximosPaginação
    ufBusca, cidades, bairros, endereçoSigla da UF com 2 letras
    cidadeBusca, bairros, endereçoNome da cidade
    cepConsulta, geo, próximosCEP com ou sem hífen
    qBusca geralTermo livre de busca
    latPróximos por coordenadaLatitude
    lngPróximos por coordenadaLongitude
    raioPróximosRaio em km. Máximo 50
    formatoConsulta CEPUse viacep para retorno compatível
    completoConsulta CEPUse true para retorno enriquecido
    mesmaCidadePróximos por CEPUse false para permitir resultados de outras cidades

    Exemplos de uso

    Veja como consumir a API em diferentes linguagens. Substitua SEU_TOKEN pelo seu token real.

    javascript
    const TOKEN = "SEU_TOKEN";
const BASE = "https://api.apicep.com.br";

// Consultar CEP
const res = await fetch(`${BASE}/cep/01001000`, {
  headers: { "Authorization": `Bearer ${TOKEN}` }
});
const endereco = await res.json();
console.log(endereco.endereco, endereco.cidade);

// Buscar CEPs próximos a uma coordenada
const proximos = await fetch(
  `${BASE}/cep/proximos?lat=-23.5676&lng=-46.6492&raio=2&limit=5`,
  { headers: { "Authorization": `Bearer ${TOKEN}` } }
).then(r => r.json());

    Códigos de erro

    Todas as respostas de erro retornam um JSON no formato { "mensagem": "..." } acompanhado de um código interno entre parênteses (ex.: Cod.(2001)) que identifica precisamente o erro ocorrido.

    HTTPQuando ocorre
    200Sucesso.
    400Parâmetro inválido (CEP, UF, latitude, longitude, código IBGE, texto de busca, etc.).
    401Token ausente, mal formatado, inválido ou desativado.
    402Sem assinatura ativa ou assinatura expirada.
    403Conta bloqueada.
    404CEP, endereço, cidade, bairro ou IBGE não encontrado.
    405Método HTTP não permitido. Apenas GET é aceito.
    429Limite diário de consultas do plano atingido.
    500Erro interno ao processar a requisição.

    Exemplos de resposta

    Token ausente (401)

    json
    {
  "mensagem": "Token de autenticação não fornecido. Use o header 'Authorization: Bearer SEU_TOKEN'. Cod.(7007)"
}

    Token inválido (401)

    json
    {
  "mensagem": "Token inválido! Cod.(4002)"
}

    Sem assinatura ativa (402)

    json
    {
  "mensagem": "Você não possui uma assinatura ativa. Contrate um plano. Cod.(7771)"
}

    CEP inválido (400)

    json
    {
  "mensagem": "O CEP deve conter 8 números. Cod.(1102)"
}

    CEP não encontrado (404)

    json
    {
  "mensagem": "CEP não encontrado. Cod.(2001)"
}

    Limite diário atingido (429)

    json
    {
  "mensagem": "Limite diário de 1000 consultas atingido. Faça upgrade do plano. Cod.(4290)"
}