v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB

CEPs

Consultar

Esta operação permite consultar CEPs utilizando os seguintes critérios de pesquisa:

codigo_ibge: Pesquisa pelo CEP referente a uma localidade, conforme o código IBGE do município
uf: Pesquisa utilizando os dois caracteres referentes à Unidade da Federação. Ex: 'PR'.
logradouro: Pesquisa pelo logradouro completo ou por parte dele. Mínimo de 3 caracteres.
localidade: Pesquisa pelo nome completo da localidade ou por parte dele.

É necessário informar ao menos dois parâmetros para consulta. No caso especial de municípios que possuem um único CEP (não dividido em logradouros), é possível realizar a consulta informando apenas o parâmetro codigo_ibge.

get/ceps

Query parameters

codigo_ibgestring

Código IBGE (7 dígitos) do município

ufstring

Sigla da Unidade da Federação (UF)

logradourostring

Logradouro completo ou parte dele (mínimo 3 caracteres)

localidadestring

Nome da localidade (município, distrito ou povoado) completo ou parte

Response

Requisição processada com sucesso

cepstring

Código CEP (8 dígitos, apenas números)

tipo'localidade' | 'logradouro' | 'unidade_operacional' | 'grande_usuario'

Tipo do CEP

nomestring

Nome do estabelecimento (para CEPs do tipo unidade_operacional ou grande_usuario)

ufstring

Sigla da Unidade da Federação

nome_localidadestring

Nome da localidade (município, distrito ou povoado)

codigo_ibgestring

Código IBGE do município (7 dígitos)

tipo_logradourostring

Tipo do logradouro (por exemplo, Rua, Avenida)

nome_logradourostring

Nome do logradouro

bairrostring

Nome do bairro onde inicia o CEP retornado

descricaostring

Descrição amigável do endereço

Example response

[
  {
    "cep": "69909032",
    "tipo": "logradouro",
    "uf": "AC",
    "nome_localidade": "Rio Branco",
    "codigo_ibge": "1200401",
    "tipo_logradouro": "Rua",
    "nome_logradouro": "Colinas",
    "bairro": "Rosa Linda",
    "descricao": "Rua Colinas, Rio Branco, AC"
  }
]