Car Ratings by Make, Model & Year (KBB)

{
  "type": "object",
  "required": [
    "year",
    "model",
    "make"
  ],
  "properties": {
    "make": {
      "type": "string",
      "description": "Make name in lowercase slug format (e.g. toyota, honda, ford)."
    },
    "year": {
      "type": "string",
      "description": "Vehicle model year (e.g. 2024)."
    },
    "model": {
      "type": "string",
      "description": "Model name in lowercase slug format (e.g. camry, civic, f-150)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "make": {
          "type": "string",
          "description": "Echoes the requested make, e.g. 'toyota'."
        },
        "year": {
          "type": "string",
          "description": "Echoes the requested year, e.g. '2023'."
        },
        "model": {
          "type": "string",
          "description": "Echoes the requested model, e.g. 'camry'."
        },
        "ratings": {
          "type": "object",
          "description": "An open set of KBB expert rating categories -- the vendor documents expert_overall, overall_rating, performance, comfort, quality, reliability, styling, and value as possible keys, but only expert_overall was observed on a real fixture (a 2023 Toyota Camry, 4.6). Which keys appear varies by vehicle, and an obscure or discontinued vehicle (a 1990 Yugo GV, observed) can return a completely empty ratings object rather than an error -- treat a missing key, or an entirely empty object, as 'no rating data on file', not as a failed call.",
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on both real calls observed, including the empty-ratings case."
    }
  },
  "description": "The car ratings result, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}