---
title: "Consultar"
method: GET
path: "/ceps"
tags: ["CEPs"]
---

# Consultar

`GET /ceps`

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**.

## Query parameters

- `codigo_ibge` string
- `uf` string
- `logradouro` string
- `localidade` string

## Response `200`

Requisição processada com sucesso

- CEPResponse[]
  - `cep` string — Código CEP (8 dígitos, apenas números)
  - `tipo` 'localidade' | 'logradouro' | 'unidade_operacional' | 'grande_usuario' — Tipo do CEP
  - `nome` string — Nome do estabelecimento (para CEPs do tipo unidade_operacional ou grande_usuario)
  - `uf` string — Sigla da Unidade da Federação
  - `nome_localidade` string — Nome da localidade (município, distrito ou povoado)
  - `codigo_ibge` string — Código IBGE do município (7 dígitos)
  - `tipo_logradouro` string — Tipo do logradouro (por exemplo, Rua, Avenida)
  - `nome_logradouro` string — Nome do logradouro
  - `bairro` string — Nome do bairro onde inicia o CEP retornado
  - `descricao` string — Descrição amigável do endereço

## Other responses

- `400` — Requisição inválida
- `401` — Não autorizado

---

[API](https://skmtc.net/focusnfe/apis/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele.md) · [All operations](https://skmtc.net/focusnfe/apis/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/focusnfe/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele/versions/a32e528fc383/schema)