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 |
JSON Schema
{
"$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.
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.