{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/agricultural-statistics-service/refs/heads/main/json-schema/quickstats-api-statistics-record-schema.json",
  "title": "Statistics Record",
  "description": "A single agricultural statistics data record from the QuickStats database.",
  "type": "object",
  "properties": {
    "source_desc": {
      "type": "string",
      "description": "Data source type (SURVEY or CENSUS).",
      "example": "SURVEY"
    },
    "sector_desc": {
      "type": "string",
      "description": "High-level sector of the agricultural economy.",
      "example": "CROPS"
    },
    "group_desc": {
      "type": "string",
      "description": "Commodity group within the sector.",
      "example": "FIELD CROPS"
    },
    "commodity_desc": {
      "type": "string",
      "description": "Name of the agricultural commodity.",
      "example": "CORN"
    },
    "class_desc": {
      "type": "string",
      "description": "Commodity class or subtype.",
      "example": "ALL CLASSES"
    },
    "statisticcat_desc": {
      "type": "string",
      "description": "Statistical measurement category.",
      "example": "AREA HARVESTED"
    },
    "unit_desc": {
      "type": "string",
      "description": "Unit of measurement for the value.",
      "example": "ACRES"
    },
    "short_desc": {
      "type": "string",
      "description": "Short description combining commodity and statistic.",
      "example": "CORN - ACRES HARVESTED"
    },
    "domain_desc": {
      "type": "string",
      "description": "Domain category (TOTAL, CHEMICAL, IRRIGATION, etc.).",
      "example": "TOTAL"
    },
    "agg_level_desc": {
      "type": "string",
      "description": "Geographic aggregation level.",
      "example": "STATE"
    },
    "state_alpha": {
      "type": "string",
      "description": "Two-letter state abbreviation.",
      "example": "VA"
    },
    "state_name": {
      "type": "string",
      "description": "Full state name.",
      "example": "VIRGINIA"
    },
    "county_name": {
      "type": "string",
      "description": "County name (if county-level data).",
      "example": "FAIRFAX"
    },
    "year": {
      "type": "integer",
      "description": "Survey or census year.",
      "example": 2023
    },
    "freq_desc": {
      "type": "string",
      "description": "Data collection frequency.",
      "example": "ANNUAL"
    },
    "reference_period_desc": {
      "type": "string",
      "description": "Reference time period (YEAR, JAN, JUN, etc.).",
      "example": "YEAR"
    },
    "value": {
      "type": "string",
      "description": "Statistical value (may include formatting like commas; use as string).",
      "example": "400,000"
    },
    "CV_pct": {
      "type": "string",
      "description": "Coefficient of variation percentage (data reliability indicator).",
      "example": ""
    }
  }
}