Veículos

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.

Falar com o comercial Ver o catálogo

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.

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

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

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 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"
}

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