# 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.

- **Identificador:** `veiculos/consulta-leilao`
- **Categoria:** Veículos
- **Audiência:** Veículo
- **Endpoint:** `POST /api/v1/{tenant}/veiculos/consulta-leilao`
- **Preço de tabela:** R$ 19,040 por consulta bem-sucedida
- **Página:** https://www.proteo.com.br/api/consultas/veiculos/consulta-leilao

## 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.

## Parâmetros (corpo JSON)

| Campo | Obrigatório | Descrição |
|---|---|---|
| `plate` | sim | Placa do veículo, antiga ou Mercosul. |

## Campos de retorno (`data`)

| 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 (valores fictícios)

```json
{
  "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"
}
```