Tabela Fipe — Valor de Veículo

{
  "type": "object",
  "properties": {
    "valor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Valor Fipe formatado exatamente como a fonte oficial escreve, em reais (ex.: 'R$ 23.241,00'). Null quando a Fipe nao publica preco para este veiculo/ano ou quando nao foi possivel identificar a versao com seguranca — ver `status`."
    },
    "status": {
      "type": [
        "string",
        "null"
      ],
      "description": "Frase em portugues explicando o desfecho da consulta. Com valor: 'Valor Fipe do mes corrente para o modelo identificado.'. Sem valor, diz POR QUE: tipo de veiculo que a Fipe nao tabela (reboque/semirreboque), ano indisponivel para o modelo, motorizacao sem correspondencia, ou versao nao identificavel com seguranca. Nunca null numa resposta bem-sucedida."
    },
    "anoModelo": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Ano-modelo ao qual o preco se refere (ex.: 2011). Null quando nao houve valor."
    },
    "marcaFipe": {
      "type": [
        "string",
        "null"
      ],
      "description": "Marca como a Fipe a nomeia (ex.: 'Citroen'), que pode diferir da grafia do DENATRAN informada na consulta. Null quando nao houve valor."
    },
    "codigoFipe": {
      "type": [
        "string",
        "null"
      ],
      "description": "Codigo Fipe do modelo, no formato oficial 'NNNNNN-N' (ex.: '011072-8'). E a chave que permite reconferir o preco na fonte oficial e acompanhar o mesmo modelo mes a mes. Null quando nao houve valor."
    },
    "modeloFipe": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome COMPLETO que a Fipe da a versao precificada (ex.: 'C3 GLX 1.4/ GLX Sonora 1.4 Flex 8V 5p'). Existe para auditoria: e com ele que se confere que o preco e do veiculo consultado e nao de uma versao parente. Null quando nao houve valor."
    },
    "combustivel": {
      "type": [
        "string",
        "null"
      ],
      "description": "Combustivel da versao precificada, como a Fipe o nomeia (ex.: 'Gasolina', 'Alcool', 'Diesel'). Null quando nao houve valor."
    },
    "mesReferencia": {
      "type": [
        "string",
        "null"
      ],
      "description": "Rotulo da tabela de referencia como a Fipe o publica, em portugues (ex.: 'julho de 2026'). E o campo que diz de QUAL mes e o preco. Null quando nao houve valor."
    },
    "valorNumerico": {
      "type": [
        "number",
        "null"
      ],
      "description": "O mesmo valor em numero, para calculo direto sem parse (ex.: 23241.0). Null sempre que `valor` for null."
    }
  },
  "description": "Valor de referencia da Tabela Fipe (preco medio de veiculos) para o veiculo identificado por marca, modelo e ano-modelo. A tabela e sempre a do MES CORRENTE. Todas as chaves estao SEMPRE presentes: quando nao ha valor seguro, elas vem nulas e `status` explica o motivo — ausencia de dado nunca vira chave faltando."
}