API de Consulta de Gravame

A placa entra e a resposta diz se o veículo está alienado, para qual instituição e desde quando. Sem mensalidade, cobrado por consulta.

Perguntas frequentes

Como consultar gravame pela placa?

Uma requisição POST para /api/v1/vehicles/gravame com a placa no corpo. A resposta traz consta verdadeiro ou falso, a situação como o Detran descreve, a financeira e o histórico de contrato e restrição.

A consulta traz o nome e o CPF do financiado?

Não, e isso é decisão de produto. A fonte devolve esses campos e nós os removemos antes de responder. O que a API entrega é a situação do veículo — há alienação, de qual financeira, desde quando, qual contrato. O CNPJ da financeira fica, porque é pessoa jurídica e dado público.

O que significa a resposta vir sem gravame?

Que não há alienação fiduciária registrada para aquela placa. É uma resposta 200 normal, com consta igual a falso, e é cobrada como qualquer outra — é justamente a resposta que permite fechar uma compra.

Quanto custa uma consulta de gravame?

R$ 7,90 por consulta respondida com sucesso, sem mensalidade e sem volume mínimo. Placa ausente ou inválida devolve 400 e não é cobrada.

Por que alguns campos vêm nulos?

Porque a cobertura da fonte varia entre chamadas. Medido na mesma placa: o CNPJ da financeira e as UFs vieram preenchidos numa resposta e nulos noutra. Só consta e situacao são previsíveis; trate o resto como opcional.

Quanto tempo leva a consulta de gravame?

Mais que uma consulta de placa, porque ela vai a um órgão. Programe o timeout do seu lado com folga: o nosso limite com o fornecedor é de 30 segundos, e acima disso devolvemos 503 sem cobrar. Não a coloque no caminho síncrono de uma tela.