Growing degree days API

Computes daily Growing Degree Days from min/max temperature, a crop base temperature and an optional horizontal upper cutoff. Answers 'How many GDD accumulate with Tmin 12C, Tmax 30C, base 10C?', 'When will my crop reach maturity?'.

Price$0.04per request

MethodPOST

Route/v1/climate/growing-degree-days

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

gddgrowing-degree-daysagronomycropphenologyagriculturebase-temperatureheat-units

API URLhttps://x402.hexl.dev/v1/climate/growing-degree-days

Integration docs

Example request

{
  "tMinC": 12,
  "tMaxC": 30,
  "baseTempC": 10
}

Example response

{
  "gdd": 11,
  "meanTempUsedC": 21,
  "baseTempC": 10,
  "upperCutoffC": null,
  "tMinC": 12,
  "tMaxC": 30,
  "interpretation": "11 growing degree-days accumulated (base 10°C).",
  "formula": "GDD = max(0, (min(Tmax,upper)+max(Tmin... ,base))/2 − Tbase), single-triangle horizontal cutoff"
}

Input schema

{
  "type": "object",
  "required": [
    "tMinC",
    "tMaxC"
  ],
  "properties": {
    "tMinC": {
      "type": "number",
      "description": "Daily minimum temperature (C)",
      "examples": [
        12
      ]
    },
    "tMaxC": {
      "type": "number",
      "description": "Daily maximum temperature (C)",
      "examples": [
        30
      ]
    },
    "baseTempC": {
      "type": "number",
      "description": "Crop base temperature (default 10)",
      "examples": [
        10
      ]
    },
    "upperTempC": {
      "type": "number",
      "description": "Optional upper cutoff temperature",
      "examples": [
        30
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}