{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/vehicle-api/refs/heads/main/json-schema/vehicle-api-model-year-schema.json",
  "title": "ModelYear",
  "description": "A specific model year with available styles",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Model year ID",
      "example": 100538647
    },
    "year": {
      "type": "integer",
      "description": "Model year (4-digit)",
      "example": 2025
    },
    "states": {
      "type": "array",
      "description": "Availability states: new, used, future",
      "items": {
        "type": "string"
      }
    },
    "styles": {
      "type": "array",
      "description": "Available trim styles for this year",
      "items": {
        "$ref": "#/components/schemas/StyleSummary"
      }
    }
  }
}