Veículos

Consulta Leilão

O serviço de Consulta Leilão retorna informações sobre o processo de venda pública de veículos ao maior lance, indicando origem e possíveis implicações legais.

Falar com o comercial Ver o catálogo

Quando usar

Descrição

O serviço de Consulta Leilão fornece informações sobre leilões, que são processos de venda pública nos quais veículos são ofertados ao maior lance.

Essa condição geralmente indica que o bem foi recuperado de financiamento, envolvido em processos judiciais ou disponibilizado por órgãos públicos.

O registro de leilão é importante para que o comprador conheça a origem do veículo e possíveis implicações legais ou estruturais.

Esse dado é essencial em transações de compra e venda, pois pode influenciar no valor de revenda e na aceitação por seguradoras.

Também são apresentados detalhes adicionais, como o tipo de leilão e o comitente responsável.

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-leilao

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
`dadosVeiculo.placa`	texto
`dadosVeiculo.chassi`	texto
`dadosVeiculo.marcaModelo`	texto
`dadosVeiculo.cor`	texto
`dadosVeiculo.anoFabricacao`	número
`dadosVeiculo.anoModelo`	número
`dadosLeilao.descricao`	texto
`dadosLeilao.quantidade`	número
`dadosLeilao.detalhes[].chassi`	texto
`dadosLeilao.detalhes[].dataLeilao`	data
`dadosLeilao.detalhes[].origem`	texto
`dadosLeilao.detalhes[].tipoMonta`	texto
`dadosLeilao.detalhes[].situacao`	texto
`dadosLeilao.detalhes[].cia`	texto
`dadosLeilao.detalhes[].patio`	texto
`dadosLeilao.detalhes[].tipoMontaOrigem`	texto
`analiseRisco.descricao`	texto
`analiseRisco.indiceRisco`	texto
`analiseRisco.observacao`	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 Leilão",
  "query_slug": "consulta-leilao",
  "data": {
    "dadosVeiculo": {
      "placa": "texto",
      "chassi": "texto",
      "marcaModelo": "texto",
      "cor": "texto",
      "anoFabricacao": 0,
      "anoModelo": 0
    },
    "dadosLeilao": {
      "descricao": "texto",
      "quantidade": 0,
      "detalhes": [
        {
          "chassi": "texto",
          "dataLeilao": "2026-01-01",
          "origem": "texto",
          "tipoMonta": "texto",
          "situacao": "texto",
          "cia": "texto",
          "patio": "texto",
          "tipoMontaOrigem": "texto"
        }
      ]
    },
    "analiseRisco": {
      "descricao": "texto",
      "indiceRisco": null,
      "observacao": "texto"
    }
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "19.040"
}

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