API de Consulta de Leilão de Veículo

A placa entra e a resposta diz se o veículo passou por leilão — quando, por qual comitente, com que monta — e o score de aceitação no mercado segurador.

Perguntas frequentes

Como consultar se um carro foi de leilão pela placa?

Uma requisição POST para /api/v1/vehicles/auction com a placa no corpo. A resposta traz consta verdadeiro ou falso, cada leilão com data, comitente, pátio e monta, e o score de aceitação.

O que é o score de leilão?

Uma classificação de A a E de como o mercado segurador enxerga o veículo depois do leilão, com o percentual de aceitação e o percentual do valor de referência que ele costuma valer. É null quando não há leilão.

Por que o total pode ser menor que os registros do fornecedor?

Porque as fontes repetem o mesmo leilão. Numa placa real vieram 12 registros e só 3 eventos distintos. A API entrega cada evento uma vez e deixa o número bruto em registros_fornecedor, para conferência.

Quanto custa a consulta de leilão?

R$ 14,90 por consulta respondida, inclusive quando não consta leilão, sem mensalidade e sem volume mínimo. Placa inexistente devolve 404 e não é cobrada.

Com que frequência o dado é atualizado?

Guardamos a resposta por 24 horas por placa: leilão entra na base com dias de atraso, não horas. Repetir a mesma placa no prazo é cobrado igual.