# Consulta FIPE

O serviço de Consulta FIPE retorna o valor médio de veículos no mercado brasileiro, considerando modelo, ano, marca e versão.

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

## Quando usar

Descrição

O serviço de Consulta FIPE fornece uma estimativa do valor de mercado do veículo, amplamente utilizada em compra e venda, financiamentos e cálculo de impostos como o IPVA.

Também apresenta detalhes adicionais, como especificações e histórico de preços.

## Parâmetros (corpo JSON)

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

## Campos de retorno (`data`)

| Campo | Tipo |
|---|---|
| `valor` | número |
| `codigoFipe` | texto |
| `anoModelo` | texto |
| `anoFabricacao` | número |
| `mesReferencia` | texto |
| `marca` | texto |
| `modelo` | texto |
| `categoria` | texto |
| `combustivel` | texto |
| `url` | texto |
| `principal` | booleano |
| `extra.categoria.sintetico` | texto |
| `extra.categoria.descricao` | texto |
| `extra.combustivel.sintetico` | texto |
| `extra.combustivel.descricao` | texto |
| `historico[].mes` | texto |
| `historico[].valor` | número |

## Exemplo de resposta (valores fictícios)

```json
{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Consulta FIPE",
  "query_slug": "consulta-fipe",
  "data": {
    "valor": 0,
    "codigoFipe": "texto",
    "anoModelo": "texto",
    "anoFabricacao": 0,
    "mesReferencia": "texto",
    "marca": "texto",
    "modelo": "texto",
    "categoria": "texto",
    "combustivel": "texto",
    "url": "texto",
    "principal": false,
    "extra": {
      "categoria": {
        "sintetico": "texto",
        "descricao": "texto"
      },
      "combustivel": {
        "sintetico": "texto",
        "descricao": "texto"
      }
    },
    "historico": [
      {
        "mes": "texto",
        "valor": 0
      }
    ]
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "0.540"
}
```