Vehicle Models by Year & Make (KBB)

{
  "type": "object",
  "required": [
    "year",
    "make_id"
  ],
  "properties": {
    "year": {
      "type": "string",
      "description": "Vehicle model year (e.g. 2024). Valid range: 1992 to the latest available year."
    },
    "make_id": {
      "type": "string",
      "description": "KBB Make ID obtained from get_makes endpoint (e.g. 49 for Toyota, 18 for Honda)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "modelSelections": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "makeId": {
                "type": "integer",
                "description": "Echoes the requested make_id."
              },
              "atcMake": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "modelId": {
                "type": "integer",
                "description": "KBB's internal numeric model id."
              },
              "makeName": {
                "type": "string",
                "description": "e.g. 'Toyota', 'Honda'."
              },
              "atcModels": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": true
                },
                "description": "Usually one entry, but a model can map to more than one underlying code (observed on Toyota 'MR2', which lists both an 'MR2' and an 'MR2 Spyder' code) -- do not assume a single entry."
              },
              "modelName": {
                "type": "string"
              },
              "isSelected": {
                "type": "boolean",
                "description": "Observed false on every model in both real fixtures."
              },
              "isEvergreen": {
                "type": "boolean",
                "description": "Observed false on every model in both real fixtures."
              },
              "atcClassSeries": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "name": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "description": "Observed with both code and name null on every model in both real fixtures -- KBB has not populated a class series value for any model seen so far.",
                "additionalProperties": true
              },
              "modelMarketName": {
                "type": "string",
                "description": "The consumer-facing model name, e.g. 'RAV4 Hybrid'."
              },
              "marketingModelName": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Observed null on every model in both real fixtures (Toyota and Honda, 2024) -- an alternate marketing name KBB has not populated for any model seen so far."
              },
              "normalizedModelName": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Observed null on every model in both real fixtures."
              }
            },
            "additionalProperties": true
          },
          "description": "One entry per model KBB tracks for the requested year/make. This key is ABSENT entirely (not an empty array) when the make_id is not recognized -- observed for make_id 999999, where the raw response's `data.modelSelections` is `null` and the field map (this tool's own responseShaping) drops it rather than shipping a null array. Treat a missing `modelSelections` as 'no models for this make_id', not as a failed call -- `status` is still 'success' in that case."
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on all three real calls observed, including the empty-result case."
    }
  },
  "description": "The model list result, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}