Consulta Veicular

Campo	Descrição
valor	Valor de mercado segundo a Tabela FIPE, em reais (ex.: R$ 23.241,00)
valorNumerico	O mesmo valor em número (23241.0), para cálculo direto sem parse
mesReferencia	Mês/ano da tabela FIPE consultada, em MM/AAAA (ex.: 07/2026) — não é o mês/ano do veículo
anoModelo	Ano-modelo do veículo que foi precificado (ex.: 2023) — o mesmo ano de veiculo.anoModelo, aqui como número
combustivel	Combustível da versão precificada, na nomenclatura da FIPE (Flex) — a mesma informação que veiculo.combustivel traz na do DENATRAN (ALCOOL/GASOLINA)
codigoFipe	Código FIPE do modelo (ex.: 011072-8) — permite reconferir o preço na fonte oficial e acompanhar o mesmo modelo mês a mês
modeloFipe	Nome completo da versão precificada, na nomenclatura da FIPE
marcaFipe	Marca na nomenclatura da FIPE (pode diferir da grafia do DENATRAN em veiculo.marca)
status	Frase explicando o desfecho da avaliação — em especial, por que o valor veio nulo

A tabela consultada é sempre a do mês corrente, e mesReferencia diz explicitamente de qual mês é o preço.

Atenção aos anos: a resposta tem três, e são coisas diferentes

Campo	O que é
veiculo.anoFabricacao	Quando o veículo saiu da fábrica
veiculo.anoModelo / veiculo.fipe.anoModelo	O ano-modelo — é por ele que a FIPE precifica
veiculo.fipe.mesReferencia	O mês/ano da tabela FIPE consultada (07/2026), não do carro

É normal que os dois primeiros diferem: um veículo 2022/2023 foi fabricado em 2022 e vendido como modelo 2023, e o preço correto é o do modelo 2023. A FIPE tabela por ano-modelo e nunca por ano de fabricação. Já fipe.mesReferencia vale o mês corrente (07/2026) em toda consulta, porque descreve a tabela de preços — se você procura o ano do veículo, use fipe.anoModelo.

Quando o valor FIPE vem nulo

O valor de mercado é informado quando há Tabela FIPE disponível para o veículo. Um preço errado é pior que um preço ausente — é número que orienta compra, venda e indenização — então, na dúvida entre versões de preços diferentes, o bloco vem com valor: null e o motivo em status, em vez de um número chutado. Os casos:

• Tipo sem Tabela FIPE. A FIPE cobre carro, moto e caminhão. Reboque e semirreboque não têm Tabela FIPE e nunca terão — cerca de 3% das consultas caem aqui. Não é falha da consulta: é como a fonte funciona.
• Ano-modelo indisponível. O modelo existe na FIPE, mas não naquele ano-modelo.
• Versão não identificada com segurança. O registro do DENATRAN abrevia o nome do modelo (C3 GLX 14 FLEX) e a FIPE usa o nome comercial completo (C3 GLX 1.4/ GLX Sonora 1.4 Flex 8V 5p); há versões homônimas com preços diferentes. Quando nenhuma candidata se destaca o suficiente, o valor não é emitido.
• Motorização sem correspondência. Nenhuma versão da FIPE bate com a cilindrada registrada.

Em todos esses casos a consulta responde normalmente, com HTTP 200 e a ficha cadastral completa: o bloco veiculo.fipe é um complemento, não uma condição de sucesso. O mesmo vale se a FIPE estiver momentaneamente indisponível.

Se você já sabe marca, modelo e ano-modelo e quer apenas o preço, sem a ficha cadastral, use a consulta Tabela FIPE — Valor de Veículo.