Veículos — dados cadastrais, técnicos e históricos via API
Consulte informações cadastrais, técnicas, financeiras e históricas de veículos a partir de placa ou chassi, ou os veículos vinculados a um CPF/CNPJ.
A URL base é https://api.assertivasolucoes.com.br e os endpoints
do produto usam o caminho /veiculos/v3. Todas as chamadas exigem
um token OAuth2 no cabeçalho Authorization: Bearer.
Fluxo de consulta
O fluxo depende da informação desejada. Para dados complementares de um
veículo, faça primeiro a consulta base e reutilize o
protocolo retornado. A consulta de histórico por CPF/CNPJ é
independente da consulta base.
Consulta base
GET /veiculos/v3/consulta-base retorna os principais dados do
veículo e um protocolo. Armazene-o.
Consultas complementares
GET /veiculos/v3/demais-consultas usa o mesmo
tipo e documento, mais o
protocolo e o nome da consulta.
Histórico por documento
GET /veiculos/v3/historico-veiculos retorna os veículos
vinculados a um CPF ou CNPJ, de forma independente.
Endpoints
| Funcionalidade | Método | Endpoint |
|---|---|---|
| Gerar token de acesso | POST |
/oauth2/v3/token |
| Consultar dados base do veículo | GET |
/veiculos/v3/consulta-base |
| Consultar informações complementares | GET |
/veiculos/v3/demais-consultas |
| Consultar histórico por CPF/CNPJ | GET |
/veiculos/v3/historico-veiculos |
Consultas complementares disponíveis
O parâmetro consulta aceita os seguintes valores:
| Valor | Consulta | Informações principais |
|---|---|---|
binestadual |
BIN estadual | Dados estaduais, situação do veículo, débitos, restrições e comunicação de venda. |
binfederal |
BIN federal | Dados federais, identificação do veículo, gravame e restrições. |
binfederalrf |
BIN federal com roubo e furto | Dados federais complementados por informações de roubo e furto. |
decodificadorchassi |
Decodificador de chassi | Informações decodificadas a partir do chassi e dados de referência. |
gravame |
Gravame | Alienação fiduciária, agente financeiro, financiado e restrição financeira. |
historicoleilao |
Histórico de leilão | Registros de leilão, comitente, leiloeiro e indicadores relacionados. |
indiciosinistro |
Indício de sinistro | Indica a existência ou não de indício de sinistro. |
precificador |
Precificador | Dados do veículo e valores de referência, incluindo a Tabela FIPE. |
Finalidade de uso (LGPD)
As consultas que envolvem dados pessoais exigem o parâmetro
idFinalidade. Para a API Veículos, os valores aceitos são:
idFinalidade |
Finalidade | Descrição |
|---|---|---|
2 |
Ciclo de crédito | Uso no ciclo de proteção ao crédito, incluindo cobrança, análise da situação financeira e correta identificação. |
Estrutura e códigos
As respostas costumam trazer um cabecalho (data/hora, protocolo,
produto, funcionalidade, finalidade, indicação de reconsulta e dados de
entrada), a resposta com os dados da consulta e, quando houver,
alerta com mensagens adicionais.
| Código | Significado | Tratamento recomendado |
|---|---|---|
200 |
Consulta realizada com sucesso. | Processar e armazenar o resultado. |
400 |
Parâmetros inválidos ou em desacordo com a documentação. | Validar tipo, documento, finalidade, consulta e protocolo. |
401 |
Falha na autenticação. | Verificar o token e gerar um novo se necessário. |
403 |
Usuário sem permissão para a operação. | Confirmar as permissões da aplicação e do produto. |
500 / 502 / 503 / 504
|
Erro interno, serviço integrado, indisponibilidade ou tempo limite. | Aguardar e repetir com retentativas controladas; acionar o suporte se persistir. |
timeout, aguarde antes de realizar uma nova consulta
para o mesmo veículo.