Gerador e consulta de CEP

Gere um CEP real com o endereço para usar em testes ou descubra o endereço de um CEP.

O que você quer fazer?

Um CEP é gerado ao abrir a página. Escolha o estado ou clique em "Gerar CEP" para criar outro.

Como funciona

  • Os CEPs são reais e vêm dos Correios, pela ViaCEP: cada um existe e corresponde à rua, ao bairro e à cidade mostrados.
  • São sorteados entre ruas da capital e de outra cidade grande de cada estado, então funcionam em formulários que preenchem o endereço pelo CEP.
  • CEPs exclusivos de empresas e órgãos públicos ficam de fora.

Como usar a API

Você pode integrar o gerador de CEP à sua aplicação pela nossa API REST.

Endpoint

GET /api/generators/address

Parâmetros de query

state
Opcional. A sigla do estado, como "SP". Sem ela, o estado é sorteado.
formatted
Opcional. "false" gera o CEP só com números. Padrão: "true".

Exemplo com curl

curl "https://devtools.vmotta.dev/api/generators/address?state=PE"

Resposta

{
  "address": {
    "cep": "55016-460",
    "street": "Avenida Terezina",
    "neighborhood": "Universitário",
    "city": "Caruaru",
    "state": "PE"
  }
}