smarterweather-com · Schema

GrowingDegreeDays

Growing Degree Units for a point, forecast or season-cumulative.

CompanyWeatherDataForecastingClimate

Properties

Name Type Description
crop string Echoed crop id (`corn`, ..., or `custom`).
catalog_version integer Version of the crop catalog used to resolve thresholds.
method string GDU method applied.
thresholds object
meta object
days array Per-day GDU series (chronological).
cumulative_total number Season-to-date GDU total in the requested unit. Present only in cumulative mode (when `season_start` was supplied), and omitted even then when `meta.gaps` contains an `unfilled` span: those days have
milestones array Crop growth-stage GDU hints, present when `include_milestones=true` and the crop has catalog milestones.
location object Resolved location, as `/v1/weather` returns it. Present when the place was resolved: always for a `zip` or `location` request, and for `lat`/`lon` when the coverage check's lookup answered in time (om
View JSON Schema on GitHub

JSON Schema

smarterweather-com-growing-degree-days-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/smarterweather-com/json-schema/smarterweather-com-growing-degree-days-schema.json",
  "title": "GrowingDegreeDays",
  "description": "Growing Degree Units for a point, forecast or season-cumulative.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/smarterweather-com-agriculture-api-openapi.yml#/components/schemas/GrowingDegreeDays",
  "type": "object",
  "required": [
    "crop",
    "catalog_version",
    "method",
    "thresholds",
    "meta",
    "days"
  ],
  "properties": {
    "crop": {
      "type": "string",
      "description": "Echoed crop id (`corn`, ..., or `custom`)."
    },
    "catalog_version": {
      "type": "integer",
      "description": "Version of the crop catalog used to resolve thresholds."
    },
    "method": {
      "type": "string",
      "enum": [
        "simple",
        "modified"
      ],
      "description": "GDU method applied."
    },
    "thresholds": {
      "$ref": "#/$defs/GddThresholds"
    },
    "meta": {
      "$ref": "#/$defs/GddMeta"
    },
    "days": {
      "type": "array",
      "description": "Per-day GDU series (chronological).",
      "items": {
        "$ref": "#/$defs/GddDay"
      }
    },
    "cumulative_total": {
      "type": "number",
      "format": "double",
      "description": "Season-to-date GDU total in the requested unit. Present only in\ncumulative mode (when `season_start` was supplied), and omitted\neven then when `meta.gaps` contains an `unfilled` span: those days\nhave no observed data, so the sum would under-count the season.\nTreat an absent total on a `season_start` request as \"season total\nunavailable\" and fall back to the per-day series, which is still\ngood for the days it covers. `meta.gaps` names the window that was\nlost.\n"
    },
    "milestones": {
      "type": "array",
      "description": "Crop growth-stage GDU hints, present when `include_milestones=true`\nand the crop has catalog milestones.\n",
      "items": {
        "$ref": "#/$defs/GddMilestone"
      }
    },
    "location": {
      "$ref": "#/$defs/Location",
      "description": "Resolved location, as `/v1/weather` returns it. Present when the\nplace was resolved: always for a `zip` or `location` request, and\nfor `lat`/`lon` when the coverage check's lookup answered in time\n(omitted when that check fails open).\n"
    }
  },
  "$defs": {
    "GddDay": {
      "type": "object",
      "description": "One day of GDU output.",
      "required": [
        "date",
        "gdu"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Local calendar date for this day."
        },
        "gdu": {
          "type": "number",
          "format": "double",
          "description": "GDU accrued on this day, in the requested unit."
        },
        "tmax_c": {
          "type": "number",
          "format": "double",
          "description": "Daily maximum temperature in °C (metric responses)."
        },
        "tmin_c": {
          "type": "number",
          "format": "double",
          "description": "Daily minimum temperature in °C (metric responses)."
        },
        "tmax_f": {
          "type": "number",
          "format": "double",
          "description": "Daily maximum temperature in °F (imperial responses)."
        },
        "tmin_f": {
          "type": "number",
          "format": "double",
          "description": "Daily minimum temperature in °F (imperial responses)."
        },
        "cumulative_gdu": {
          "type": "number",
          "format": "double",
          "description": "Running season-to-date total through this day. Present only in\ncumulative mode (when `season_start` was supplied).\n"
        },
        "missing": {
          "type": "boolean",
          "description": "True when the underlying day had no temperature data."
        },
        "interpolated": {
          "type": "boolean",
          "description": "True when this day's value was interpolated across a gap."
        }
      }
    },
    "GddGap": {
      "type": "object",
      "description": "A run of missing observed days affecting a cumulative total.",
      "required": [
        "start",
        "end",
        "days",
        "filled"
      ],
      "properties": {
        "start": {
          "type": "string",
          "format": "date",
          "description": "First missing day (inclusive)."
        },
        "end": {
          "type": "string",
          "format": "date",
          "description": "Last missing day (inclusive)."
        },
        "days": {
          "type": "integer",
          "description": "Number of missing days in the run."
        },
        "filled": {
          "type": "string",
          "description": "How the gap was handled, e.g. `interpolated` (short gap filled\nfrom adjacent days) or `unfilled` (long gap surfaced, not\nsilently under-counted).\n"
        }
      }
    },
    "GddMeta": {
      "type": "object",
      "description": "Provenance for a GDU response. Nothing is silently assumed.",
      "required": [
        "day_definition",
        "computation_path",
        "source",
        "unit"
      ],
      "properties": {
        "day_definition": {
          "type": "string",
          "enum": [
            "nws",
            "local_calendar"
          ],
          "description": "The daily boundary used."
        },
        "computation_path": {
          "type": "string",
          "description": "How the series was assembled (e.g. forecast-only vs. stitched\nobserved + partial + forecast), for grid-vs-point transparency.\n"
        },
        "source": {
          "type": "string",
          "description": "Backing product mix (NBM / RTMA) used for this answer."
        },
        "freshness": {
          "type": "string",
          "description": "Human-readable data-age hint, when available."
        },
        "unit": {
          "type": "string",
          "enum": [
            "imperial",
            "metric"
          ],
          "description": "Unit system applied to numeric GDU + temperature fields."
        },
        "approximate": {
          "type": "boolean",
          "description": "True when gaps were interpolated or coverage was partial."
        },
        "gaps": {
          "type": "array",
          "description": "Missing-day runs affecting a cumulative total.",
          "items": {
            "$ref": "#/$defs/GddGap"
          }
        }
      }
    },
    "GddMilestone": {
      "type": "object",
      "description": "A crop growth-stage GDU hint from the catalog. Interpretation aid for\nclients; not a server-computed threshold.\n",
      "required": [
        "stage",
        "gdu"
      ],
      "properties": {
        "stage": {
          "type": "string",
          "description": "Growth-stage label (e.g. `emergence`, `silking`)."
        },
        "gdu": {
          "type": "number",
          "format": "double",
          "description": "Cumulative GDU (requested unit) at which the stage is reached."
        }
      }
    },
    "GddThresholds": {
      "type": "object",
      "description": "Resolved GDU thresholds, always expressed in °C.",
      "required": [
        "base_temp_c"
      ],
      "properties": {
        "base_temp_c": {
          "type": "number",
          "format": "double",
          "description": "Base (lower) temperature threshold in °C."
        },
        "upper_temp_c": {
          "type": "number",
          "format": "double",
          "description": "Upper cutoff in °C (present only for the modified method)."
        }
      }
    },
    "Location": {
      "type": "object",
      "description": "Resolved location.",
      "required": [
        "lat",
        "lon",
        "name",
        "timezone"
      ],
      "properties": {
        "lat": {
          "type": "number",
          "format": "double",
          "minimum": -90,
          "maximum": 90
        },
        "lon": {
          "type": "number",
          "format": "double",
          "minimum": -180,
          "maximum": 180
        },
        "name": {
          "type": "string",
          "description": "Human-readable place name, usually without the state; see\n`region`. The resolved place name, else the city, else the\nnearest city. Empty when none is known.\n"
        },
        "region": {
          "type": "string",
          "description": "State or region abbreviation."
        },
        "country": {
          "type": "string",
          "description": "ISO 3166-1 alpha-2 country code."
        },
        "timezone": {
          "type": "string",
          "description": "IANA timezone identifier."
        },
        "county": {
          "type": "string",
          "description": "County name (US only)."
        },
        "zip": {
          "type": "string",
          "description": "ZIP code (US only)."
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/smarterweather-com-growing-degree-days"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.