Integre em minutos

Busca de CEP ao vivo

Digite um CEP e veja a resposta real da API. Sem cadastro para testar.

Autenticação

Três formas de acesso, do protótipo à produção corporativa:

API Key (recomendado para apps)

Envie sua chave no cabeçalho X-Api-Key:

copiarcurl "https://branux-cep.branux.com.br/api/cep/v2/enderecos/01001000" \
  -H "X-Api-Key: bcep_a1b2c3d.SUACHAVESECRETA"

JWT corporativo

Use o mesmo token do Branux ERP, com isolamento por empresa (multi-tenant por subdomínio):

copiarcurl "https://branux-cep.com.br/api/cep/v2/enderecos/01001000" \
  -H "Authorization: Bearer SEU_TOKEN_JWT"

Anônimo

Sem chave, limitado a 100 consultas/dia por IP — ideal para testes e provas de conceito.

Exemplos de código

Busca por CEP nas linguagens mais usadas:

copiarconst cep = "01001000";
const r = await fetch(`https://branux-cep.branux.com.br/api/cep/v2/enderecos/${cep}`, {
  headers: { "X-Api-Key": "bcep_a1b2c3d.SUACHAVESECRETA" }
});
const endereco = await r.json();
console.log(endereco.logradouro, endereco.localidade, endereco.uf);

copiar$ch = curl_init("https://branux-cep.branux.com.br/api/cep/v2/enderecos/01001000");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: bcep_a1b2c3d.SUACHAVESECRETA"]);
$endereco = json_decode(curl_exec($ch), true);
echo $endereco["logradouro"];

copiarimport requests
r = requests.get(
    "https://cep.branux.com.br/api/cep/v2/enderecos/01001000",
    headers={"X-Api-Key": "bcep_a1b2c3d.SUACHAVESECRETA"})
endereco = r.json()
print(endereco["logradouro"], endereco["localidade"], endereco["uf"])

copiarusing var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", "bcep_a1b2c3d.SUACHAVESECRETA");
var json = await http.GetStringAsync(
    "https://branux-cep.branux.com.br/api/cep/v2/enderecos/01001000");
Console.WriteLine(json);

Endereços

Exemplo de resposta:

{
  "cep": "01001000",
  "logradouro": "Praça da Sé",
  "complemento": "lado ímpar",
  "bairro": "Sé",
  "localidade": "São Paulo",
  "uf": "SP"
}

Dados geográficos

Unidades dos Correios

Administração (planos Negócios e Enterprise)

Códigos de resposta