Serviços / Geolocalização

Zona de risco por CEP

GET/api/v1/geoloc/risk-zones

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.

Fonte: LLM · tempo real

Parâmetros

zip_codestringObrigatório

CEP no formato `04610-001`.

04610-001
query
countrystringOpcional

País. Hoje apenas `brazil`.

brazil
query

Campos da resposta

CEP

cep

string

Logradouro

logradouro

string

Complemento

complemento

string

Unidade

unidade

string

Bairro

bairro

string

Cidade

localidade

string

UF

uf

string

Estado

estado

string

Região

regiao

string

Código IBGE

ibge

string

Código GIA

gia

string

DDD

ddd

string

Código SIAFI

siafi

string

Classificação de risco

cep_risk_mapper

object

Cor do risco

cep_risk_mapper.color_risk

string

Justificativa

cep_risk_mapper.risk_description

string

Data da consulta

cep_risk_mapper.consult_date

string

CEP consultado

cep_risk_mapper.cep

string

Exemplo de resposta

Modelo de resposta: GeolocRiskZonesResponseDTO
JSON · response
{
  "success": true,
  "code": 200,
  "code_message": "A requisição foi processada com sucesso.",
  "errors": [],
  "header": null,
  "data_count": 1,
  "data": [
    {
      "cep": "04610-001",
      "logradouro": "Rua Exemplo",
      "complemento": null,
      "unidade": null,
      "bairro": "Campo Belo",
      "localidade": "São Paulo",
      "uf": "SP",
      "estado": null,
      "regiao": null,
      "ibge": null,
      "gia": null,
      "ddd": null,
      "siafi": null,
      "cep_risk_mapper": {
        "color_risk": "green",
        "risk_description": "Região residencial com baixa incidência registrada.",
        "consult_date": "2026-08-31",
        "cep": "04610-001"
      }
    }
  ]
}

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.