Sobre esta API

Devolve o endereço do CEP com a classificação de risco da região — verde, amarelo ou vermelho — e a justificativa.

Envie zip_code no formato 04610-001. Hoje só o Brasil está disponível.

É um parecer sobre dados públicos, não estatística oficial de criminalidade: use como sinal dentro da análise, não como motivo único de recusa.

Tecnologia

LLM · Atualização: tempo real

Requisição

GET /api/v1/geoloc/risk-zones

Autenticação HTTP Basic: public_key:secret_key em Base64. Guarde a chave secreta no servidor.

Cabeçalho	Descrição
`Authorization` Obrigatório	Chave de API em Basic: `public_key:secret_key` em Base64.
`X-Project-Id` Opcional	Projeto que recebe a chamada. Sem ele, vale o projeto padrão da conta.
`Idempotency-Key` Opcional	Repetir a mesma chave em até 24 horas devolve a resposta anterior, sem executar nem cobrar de novo.

Parâmetros

Campo	Tipo e local	Descrição
`zip_code` Obrigatório	stringquery	CEP no formato `04610-001`. Exemplo: `04610-001`
`country` Opcional	stringquery	País. Hoje apenas `brazil`. Exemplo: `brazil`

1curl --request GET 'https://api.apifordevs.com/api/v1/geoloc/risk-zones?zip_code=04610-001&country=brazil' \
2  --user "afd_live_pk_...:$AFD_SECRET_KEY" \
3  --header "X-Project-Id: $AFD_PROJECT_ID"

1import os
2import requests
3
4response = requests.request(
5    "GET",
6    "https://api.apifordevs.com/api/v1/geoloc/risk-zones?zip_code=04610-001&country=brazil",
7    auth=("afd_live_pk_...", os.environ["AFD_SECRET_KEY"]),
8    headers={"X-Project-Id": os.environ["AFD_PROJECT_ID"]},
9    timeout=30,
10)
11response.raise_for_status()
12print(response.json())

1const response = await fetch("https://api.apifordevs.com/api/v1/geoloc/risk-zones?zip_code=04610-001&country=brazil", {
2  method: "GET",
3  headers: {
4    Authorization: "Basic " + Buffer.from(
5      "afd_live_pk_...:" + process.env.AFD_SECRET_KEY
6    ).toString("base64"),
7    "X-Project-Id": process.env.AFD_PROJECT_ID,
8  },
9  signal: AbortSignal.timeout(30000),
10});
11if (!response.ok) throw new Error(`HTTP ${response.status}`);
12console.log(await response.json());

Campos de resposta

Campos e tipos publicados no catálogo desta API.

CEPcepstring
Logradourologradourostring
Complementocomplementostring
Unidadeunidadestring
Bairrobairrostring
Cidadelocalidadestring
UFufstring
Estadoestadostring
Regiãoregiaostring
Código IBGEibgestring
Código GIAgiastring
DDDdddstring

Exemplo de resposta

1{
2  "success": true,
3  "code": 200,
4  "code_message": "A requisição foi processada com sucesso.",
5  "errors": [],
6  "header": null,
7  "data_count": 1,
8  "data": [
9    {
10      "cep": "04610-001",
11      "logradouro": "Rua Exemplo",
12      "complemento": null,
13      "unidade": null,
14      "bairro": "Campo Belo",
15      "localidade": "São Paulo",
16      "uf": "SP",
17      "estado": null,
18      "regiao": null,
19      "ibge": null,
20      "gia": null,
21      "ddd": null,
22      "siafi": null,
23      "cep_risk_mapper": {
24        "color_risk": "green",
25        "risk_description": "Região residencial com baixa incidência registrada.",
26        "consult_date": "2026-08-31",
27        "cep": "04610-001"
28      }
29    }
30  ]
31}

Respostas e cobrança

HTTP	Descrição	Cobrança
`200`	Sucesso.	Sujeita à cobrança
`400` `bad_request` `live_key_cannot_use_dev_mode`	Arquivo ou parâmetro que a rota não consegue processar, projeto inválido, ou `dev_mode=true` com chave de produção.	Sem cobrança
`401` `unauthorized`	Credencial ausente, inválida ou revogada.	Sem cobrança
`402` `payment_required`	Saldo insuficiente ou limite de gasto diário atingido.	Sem cobrança
`403` `forbidden` `ip_not_allowed` `test_key_cannot_run_live`	E-mail da conta não verificado, chave sem escopo para o serviço, IP fora da allowlist do projeto ou chave de teste sem `dev_mode=true`.	Sem cobrança
`409` `conflict`	Requisição com a mesma `Idempotency-Key` ainda em andamento.	Sem cobrança
`422` `validation_error`	Parâmetro obrigatório ausente ou fora do formato, ou `Idempotency-Key` repetida com outro conteúdo.	Sem cobrança
`429` `rate_limit_exceeded`	Limite de requisições por minuto da chave atingido.	Sem cobrança
`500` `internal_error`	Falha interna.	Sem cobrança
`503` `service_unavailable`	Serviço desativado ou temporariamente indisponível.	Sem cobrança

Casos de uso

Precificação de seguro por região

Ajustar prêmio pelo risco do bairro de pernoite do veículo.

Logística e entrega

Sinalizar entrega em área de risco para decidir janela, transportadora ou exigência de conferência.

Zona de risco por CEP