Consulta Proprietário Atual
O serviço de Consulta Proprietário Atual retorna informações sobre o proprietário atual do veículo, essenciais para verificar a legalidade em transações.
Quando usar
Descrição
O serviço de Consulta Proprietário Atual fornece informações sobre o proprietário atual do veículo, essenciais para verificar a legalidade em transações.
Ele inclui detalhes sobre o proprietário, como nome, documento e renavam.
Essas informações são essenciais para transações de compra e venda, permitindo verificar se o veículo pode ser transferido sem pendências judiciais ou bloqueios.
Também são apresentados dados sobre o proprietário e endereço.
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-proprietario-atual
| 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 |
|---|---|
identificacao.placa |
texto |
identificacao.chassi |
texto |
identificacao.renavam |
texto |
proprietario.nome |
texto |
proprietario.documento |
texto |
proprietario.tipoDocumento |
texto |
marca.descricao |
texto |
marca.fipeId |
número |
marca.sintetico |
booleano |
modelo.descricao |
texto |
modelo.bruto |
texto |
modelo.sintetico |
booleano |
modelo.versao |
texto |
modelo.anoFabricacao |
número |
modelo.anoModelo |
número |
classificacao.tipoVeiculo |
texto |
classificacao.especie |
texto |
classificacao.combustivel |
texto |
carroceria.tipo |
texto |
carroceria.capacidadeCarga |
texto |
cor.descricao |
texto |
localizacao.uf |
texto |
localizacao.cidade |
texto |
origem.procedencia |
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 Proprietário Atual",
"query_slug": "consulta-proprietario-atual",
"data": {
"identificacao": {
"placa": "texto",
"chassi": "texto",
"renavam": "texto"
},
"proprietario": {
"nome": "texto",
"documento": "texto",
"tipoDocumento": "texto"
},
"marca": {
"descricao": "texto",
"fipeId": 0,
"sintetico": false
},
"modelo": {
"descricao": "texto",
"bruto": "texto",
"sintetico": false,
"versao": null,
"anoFabricacao": 0,
"anoModelo": 0
},
"classificacao": {
"tipoVeiculo": "texto",
"especie": "texto",
"combustivel": null
},
"carroceria": {
"tipo": null,
"capacidadeCarga": null
},
"cor": {
"descricao": "texto"
},
"localizacao": {
"uf": "texto",
"cidade": "texto"
},
"origem": {
"procedencia": null
}
},
"consulted_at": "2026-01-01T12:00:00Z",
"query_cost": "2.400"
}
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