Veículos

Consulta Índice de Risco

O serviço de Consulta Índice de Risco retorna um indicador do risco do veículo, considerando histórico de acidentes e pendências jurídicas.

Falar com o comercial Ver o catálogo

Quando usar

Descrição

O serviço de Consulta Índice de Risco fornece um indicador utilizado para avaliar o nível de risco de um veículo.

Ele considera fatores como histórico de acidentes, envolvimento em atividades ilícitas, pendências jurídicas e problemas com a documentação.

Essas informações são cruciais para transações de compra e venda, ajudando a garantir a legalidade do veículo e evitar problemas futuros.

O índice de risco pode ser classificado em diferentes níveis, oferecendo uma visão sobre a segurança do veículo e eventuais complicações.

Além disso, são apresentados dados sobre a situação do veículo e restrições ativas.

Requisição

Autenticação por chave de API (cabeçalho Authorization: Bearer), criada no painel com esta consulta no escopo.

POST /api/v1/{tenant}/veiculos/consulta-indice-de-risco

Campo	Obrigatório	Descrição
`plate`	sim	Placa do veículo, antiga ou Mercosul.

{
  "plate": "ABC1D23"
}

Campos de retorno

Campos dentro de data. [] indica lista.

Campo	Tipo
`tabs.transf_titu_cnpj_seg.quantidade_registros`	número
`tabs.transf_titu_cnpj_seg.produto`	texto
`tabs.hist_ex_viatu_policial.quantidade_registros`	número
`tabs.hist_ex_viatu_policial.produto`	texto
`tabs.hist_ex_frota_locadora.quantidade_registros`	número
`tabs.hist_ex_frota_locadora.produto`	texto
`tabs.ind_util_excessiva_taxi.quantidade_registros`	número
`tabs.ind_util_excessiva_taxi.produto`	texto
`tabs.hist_ex_frota_ent_religiosa.quantidade_registros`	número
`tabs.hist_ex_frota_ent_religiosa.produto`	texto
`tabs.hist_ex_frota_publica.quantidade_registros`	número
`tabs.hist_ex_frota_publica.produto`	texto
`tabs.hist_ex_frota_seg_privada.quantidade_registros`	número
`tabs.hist_ex_frota_seg_privada.produto`	texto
`tabs.hist_ex_taxi.quantidade_registros`	número
`tabs.hist_ex_taxi.produto`	texto
`tabs.hist_ex_frota.quantidade_registros`	número
`tabs.hist_ex_frota.produto`	texto
`tabs.hist_restr_med_apol_seguro.quantidade_registros`	número
`tabs.hist_restr_med_apol_seguro.produto`	texto
`tabs.hist_com_loja_salvados.quantidade_registros`	número
`tabs.hist_com_loja_salvados.produto`	texto
`tabs.ind_busca_apre_fut_leilao_fin.quantidade_registros`	número
`tabs.ind_busca_apre_fut_leilao_fin.produto`	texto
`tabs.hist_acidente_transito.quantidade_registros`	número
`tabs.hist_acidente_transito.produto`	texto
`tabs.hist_inden_integr_seguradora.quantidade_registros`	número
`tabs.hist_inden_integr_seguradora.produto`	texto
`tabs.hist_danos_avarias.quantidade_registros`	número
`tabs.hist_danos_avarias.produto`	texto
`tabs.suspeita_chassi_adulterada.quantidade_registros`	número
`tabs.suspeita_chassi_adulterada.produto`	texto
`tabs.rel_embar_plataf_guincho.quantidade_registros`	número
`tabs.rel_embar_plataf_guincho.produto`	texto
`tabs.vei_utilizado_comet_crime.quantidade_registros`	número
`tabs.vei_utilizado_comet_crime.produto`	texto
`detalhes[].chave`	texto
`detalhes[].resposta[].produto`	texto
`detalhes[].resposta[].instituicao`	texto
`detalhes[].resposta[].cnpj`	texto
`detalhes[].resposta[].ano_informacao`	texto

Exemplo de resposta

Estrutura real da resposta, com valores fictícios.

{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Consulta Índice de Risco",
  "query_slug": "consulta-indice-de-risco",
  "data": {
    "tabs": {
      "transf_titu_cnpj_seg": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "hist_ex_viatu_policial": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "hist_ex_frota_locadora": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "ind_util_excessiva_taxi": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "hist_ex_frota_ent_religiosa": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "hist_ex_frota_publica": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "hist_ex_frota_seg_privada": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "hist_ex_taxi": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "hist_ex_frota": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "hist_restr_med_apol_seguro": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "hist_com_loja_salvados": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "ind_busca_apre_fut_leilao_fin": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "hist_acidente_transito": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "hist_inden_integr_seguradora": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "hist_danos_avarias": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "suspeita_chassi_adulterada": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "rel_embar_plataf_guincho": {
        "quantidade_registros": 0,
        "produto": "texto"
      },
      "vei_utilizado_comet_crime": {
        "quantidade_registros": 0,
        "produto": "texto"
      }
    },
    "detalhes": [
      {
        "chave": "texto",
        "resposta": [
          {
            "produto": "texto",
            "instituicao": "texto",
            "cnpj": "texto",
            "ano_informacao": "texto"
          }
        ]
      }
    ]
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "4.320"
}

Cobrança e respostas

O valor é cobrado por consulta bem-sucedida.
200 — consulta processada (veja status no corpo da resposta)
401 — token ausente, inválido, inativo ou expirado
403 — serviço fora do escopo da chave, IP não autorizado ou limite de consumo excedido
422 — campo obrigatório ausente/inválido ou payload acima do limite do serviço
429 — limite de requisições por minuto da chave excedido
504 — tempo máximo de execução do serviço excedido