Veículos

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

CampoObrigatórioDescrição
plate sim Placa do veículo, antiga ou Mercosul.
{
  "plate": "ABC1D23"
}

Campos de retorno

Campos dentro de data. [] indica lista.

CampoTipo
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