Consulta CEP

API para consulta de endereços por CEP em todo o Brasil. Retorna logradouro, bairro, cidade, UF e demais dados.

Planos Disponíveis

Gratuito

Grátis

Consultas/minuto 3

requisições/dia 500

requisições/mês 10,000

3 consultas por minuto. 500 consultas/dia. 10.000 consultas/mês.

Começar Grátis

Documentação da API

Autenticação

Todas as requisições devem incluir o token no header:

Authorization: Bearer your_token

O token é gerado ao assinar um plano. Cadastre-se para obter o seu.

GET /api/v1/cep/{cep} Consultar endereço por CEP

Parâmetros

Param	Tipo	Obrigatório	Descrição
`cep`	string	Sim	CEP com 8 dígitos (com ou sem hífen)

Exemplo de Requisição

curl "https://pwapi.net/api/v1/cep/85010010" -H "Authorization: Bearer your_token"

Resposta de Sucesso 200

{
    "success": true,
    "data": {
        "cep": "85010010",
        "tipo": "logradouro",
        "logradouro_tipo": "Rua",
        "logradouro": "Guaíra",
        "complemento": "- de 2501/2502 a 3790/3791",
        "bairro": "Centro",
        "localidade": "Guarapuava",
        "uf": "PR",
        "ibge": "4109401"
    }
}

Códigos de Erro

401 Não autenticado 403 Sem permissão 404 CEP não encontrado 422 CEP inválido 429 Rate limit 500 Erro interno

GET /api/v1/estados Listar todos os estados

Exemplo de Requisição

curl "https://pwapi.net/api/v1/estados" -H "Authorization: Bearer your_token"

Resposta de Sucesso 200

{
    "success": true,
    "data": [
        { "uf": "AC", "nome": "Acre" },
        { "uf": "AL", "nome": "Alagoas" },
        { "uf": "AM", "nome": "Amazonas" },
        { "uf": "CE", "nome": "Ceará" },
        { "uf": "SP", "nome": "São Paulo" }
        ...
    ],
    "total": 27
}

GET /api/v1/estados/{uf}/municipios Listar municípios por estado

Parâmetros

Param	Tipo	Obrigatório	Descrição
`uf`	string	Sim	Sigla do estado com 2 letras (ex: SP, CE)

Exemplo de Requisição

curl "https://pwapi.net/api/v1/estados/CE/municipios" -H "Authorization: Bearer your_token"

Resposta de Sucesso 200

{
    "success": true,
    "data": [
        { "id": 1, "nome": "Abaiara", "cep": "63240000", "uf": "CE" },
        { "id": 2, "nome": "Acarape", "cep": "62785000", "uf": "CE" },
        { "id": 3, "nome": "Acaraú", "cep": "62580000", "uf": "CE" },
        ...
    ],
    "uf": "CE",
    "total": 184
}

Códigos de Erro

401 Não autenticado 404 Nenhum município encontrado 422 UF inválida 429 Rate limit

Headers de Rate Limit

Toda resposta inclui headers com informações de uso:

Header	Descrição
`X-RateLimit-Daily-Limit`	Limite diário do plano
`X-RateLimit-Daily-Remaining`	Requisições restantes hoje
`X-RateLimit-Monthly-Limit`	Limite mensal do plano
`X-RateLimit-Monthly-Remaining`	Requisições restantes no mês

Pronto para começar?

Cadastre-se gratuitamente e comece a usar a API em minutos.

Criar Conta Grátis