Weather, Frost & Zones

Current conditions, hourly and 16-day forecasts, night-by-night frost risk, frost date windows, and USDA hardiness zone lookups: everything a grower needs to plan around their local climate. On this page, you will find the full reference for weather, frost date, and hardiness zone endpoints, including request parameters and response shapes.

GET/v2/weather/forecast

Get garden forecast

Retrieve current conditions, the next 0 to 48 hours and the next 1 to 16 days for a US ZIP code or a latitude and longitude, with the values a gardener plans by: rain and its probability, UV, sunshine, reference evapotranspiration (ET0, the water a well watered grass field loses) and vapour pressure deficit. This is the recommended weather endpoint; the two below keep their older shape.

Weather data by Open-Meteo.com (CC BY 4.0). Every response carries meta.attribution: show its text, linked to its url, beside any weather you display, and keep the credit and the licence link when you pass the data on.

In the contiguous US, temperature, feels-like, humidity, dew point, rain and rain probability come from NOAA's National Blend of Models for as long as it forecasts (about 10 days), then from Open-Meteo's best_match; everything else comes from best_match. meta.models names the models each response used.

Location (one of)

Name
zip
Type
string
Description
US ZIP code (e.g., "27601"). The response's location adds the city and hardiness zone.
Name
lat
Type
number
Description
Latitude, -90 to 90, with lon (-180 to 180).

Optional attributes

Name
units
Type
string
Description
us (default: °F, mph, inches) or metric (°C, km/h, mm; snowfall in cm). meta.units names the unit of every kind of value.
Name
days
Type
integer
Description
Days of daily forecast from today at the location, 1 to 16. Default 7.
Name
hours
Type
integer
Description
Hours of hourly forecast from the start of the current hour, 0 to 48. Default 24.

Response: data

Name
location
Type
object
Description
zipcode, city, hardinessZone (null for a coordinate request), latitude, longitude, timezone (IANA).
Name
current
Type
object
Description
time, temperature, apparentTemperature, relativeHumidity, dewPoint, weatherCode (WMO), condition (its description), isDay, cloudCover, precipitation (preceding 15 minutes), wind (speed, direction in degrees, gusts), uvIndex, soilTemperature (surface, depth6cm).
Name
hourly
Type
array
Description
One entry per hour: time, temperature, apparentTemperature, relativeHumidity, dewPoint, precipitation, precipitationProbability, weatherCode, condition, windSpeed, windGusts, uvIndex, isDay, vapourPressureDeficit (kPa).
Name
daily
Type
array
Description
One entry per day: date, weatherCode, condition, temperatureMax, temperatureMin, precipitation, precipitationProbabilityMax, precipitationHours, snowfall, windSpeedMax, windGustsMax, windDirectionDominant, uvIndexMax, sunrise, sunset, daylightDuration and sunshineDuration (seconds), shortwaveRadiation (MJ/m²), et0, vapourPressureDeficitMax (kPa).

Times are ISO 8601 with the UTC offset in force at that moment; date is the calendar date at the location. A value the weather source did not return is null, never estimated.

Response: meta

Name
units
Type
object
Description
Unit of each kind of value (temperature covers air, feels-like, dew point and soil).
Name
attribution
Type
object
Description
text, url, licence, licenceUrl, and changes: what Verdantly changed, as the licence requires.
Name
models
Type
object
Description
temperature, precipitation and other: the models that supplied each group, first choice first.
Name
partial
Type
array
Description
Sources that failed (for example ncep_nbm_conus); the response was answered without them.

Request

GET

/v2/weather/forecast

curl -G "https://verdantly-gardening-api.p.rapidapi.com/v2/weather/forecast" \
  --data-urlencode "zip=27601" \
  --data-urlencode "days=7" \
  -H "X-RapidAPI-Host: verdantly-gardening-api.p.rapidapi.com" \
  -H "X-RapidAPI-Key: {apiKey}"

Response

{
  "data": {
    "location": {
      "zipcode": "27601",
      "city": "Raleigh, NC · Wake Co.",
      "hardinessZone": "8a",
      "latitude": 35.774451,
      "longitude": -78.63274,
      "timezone": "America/New_York"
    },
    "current": {
      "time": "2026-10-23T00:30:00-04:00",
      "temperature": 42.7,
      "apparentTemperature": 38.4,
      "relativeHumidity": 72,
      "dewPoint": 34.3,
      "weatherCode": 0,
      "condition": "Clear sky",
      "isDay": false,
      "cloudCover": 0,
      "precipitation": 0,
      "wind": {
        "speed": 1.8,
        "direction": 5,
        "gusts": 4.3
      },
      "uvIndex": 0,
      "soilTemperature": {
        "surface": 32.4,
        "depth6cm": 49.4
      }
    },
    "hourly": [
      {
        "time": "2026-10-23T00:00:00-04:00",
        "temperature": 48.7,
        "apparentTemperature": 44.4,
        "relativeHumidity": 63,
        "dewPoint": 36.6,
        "precipitation": 0,
        "precipitationProbability": 0,
        "weatherCode": 0,
        "condition": "Clear sky",
        "windSpeed": 2.7,
        "windGusts": 6.9,
        "uvIndex": 0,
        "isDay": false,
        "vapourPressureDeficit": 0.28
      }
    ],
    "daily": [
      {
        "date": "2026-10-23",
        "weatherCode": 3,
        "condition": "Overcast",
        "temperatureMax": 68.8,
        "temperatureMin": 44.1,
        "precipitation": 0,
        "precipitationProbabilityMax": 0,
        "precipitationHours": 0,
        "snowfall": 0,
        "windSpeedMax": 9.8,
        "windGustsMax": 25.7,
        "windDirectionDominant": 23,
        "uvIndexMax": 4.95,
        "sunrise": "2026-10-23T07:28:23-04:00",
        "sunset": "2026-10-23T18:28:48-04:00",
        "daylightDuration": 39633.69,
        "sunshineDuration": 36000,
        "shortwaveRadiation": 16.62,
        "et0": 0.131,
        "vapourPressureDeficitMax": 1.54
      }
    ]
  },
  "meta": {
    "version": "v2",
    "generatedAt": "2026-10-23T04:32:07.378Z",
    "units": {
      "temperature": "°F",
      "precipitation": "in",
      "et0": "in",
      "snowfall": "in",
      "windSpeed": "mph",
      "vapourPressureDeficit": "kPa"
    },
    "attribution": {
      "text": "Weather data by Open-Meteo.com",
      "url": "https://open-meteo.com/",
      "licence": "CC BY 4.0",
      "licenceUrl": "https://creativecommons.org/licenses/by/4.0/",
      "changes": "Arranged into rows by time and combined from several weather models (see meta.models) by Verdantly."
    },
    "sources": [
      {
        "name": "Open-Meteo",
        "apis": [
          "forecast"
        ]
      }
    ],
    "models": {
      "temperature": [
        "ncep_nbm_conus"
      ],
      "precipitation": [
        "ncep_nbm_conus"
      ],
      "other": [
        "best_match"
      ]
    },
    "corrections": [],
    "partial": []
  }
}

The example is truncated to one hourly and one daily entry for brevity.

GET/v2/weather/frost-risk

Get frost risk

Night by night, will it get cold enough to hurt plants? For each of the next 1 to 10 nights (18:00 to 10:00 local, starting this evening) for a US ZIP code or a latitude and longitude: the expected low, a colder case, how many of 31 ensemble forecasts reach each threshold, how the forecast moved since a day ago, any NWS frost or freeze alert, and a none, possible or likely level per threshold, judged on a low corrected by the nearest NOAA station's recent forecast errors where one qualifies.

Weather data by Open-Meteo.com (CC BY 4.0): show meta.attribution beside the data, as for the forecast. Alert ids are the National Weather Service's, unaltered; the levels are Verdantly's judgement, not an NWS product.

How the level is decided. Near an NWS station (within 25 km and 150 m of elevation, with at least 14 days of observed lows), NOAA's National Blend of Models low is corrected by that station's recent forecast errors; elsewhere the colder of the Blend and Open-Meteo's best_match is used. The station correction also shifts every ensemble member, and yardOffset is taken off that low and off every member. A threshold is likely when an NWS Frost Advisory, Freeze Watch or Freeze Warning overlaps the night, or when the low is at or below it with at least half the members agreeing (16 of 31); possible when the low is within 2 °F above it or at least 10 % of members, rounded down (3 of 31), reach it. The station correction and the rule each night used are listed in meta.corrections. In a one-year backtest at 45 US sites, the station-corrected low caught 93.3 % of frost nights against 81.6 % for the uncorrected forecast, with a similar number of false alarms (426 against 389).

Location (one of)

Name
zip
Type
string
Description
US ZIP code (e.g., "55401").
Name
lat
Type
number
Description
Latitude, -90 to 90, with lon (-180 to 180).

Optional attributes

Name
units
Type
string
Description
us (default: °F) or metric (°C).
Name
nights
Type
integer
Description
Nights from this evening, 1 to 10. Default 7.
Name
thresholds
Type
string
Description
Up to 5 comma-separated temperatures in the response unit. Default 36,32,28 (°F) or 2,0,-2 (°C).
Name
yardOffset
Type
number
Description
Degrees the garden runs colder than the forecast, 0 to 15. Default 0.

This route allows 10 requests per 10 seconds and 60 per minute.

Response: data

Name
location
Type
object
Description
As for the forecast, plus elevation (metres) of the forecast point.
Name
nights
Type
array
Description
One entry per night: date (the evening's), start, end, low (Blend in the contiguous US, else best_match), coldCaseLow, trend (previousLow, change; null past 7 days of earlier runs), ensemble (members, p10, p50, p90; null past the ensemble's 10 days), alerts (NWS ids), level, and risk (per threshold: threshold, level, membersAtOrBelow).

Response: meta

Name
models
Type
object
Description
low, coldCase, trend and ensemble: the models used.
Name
corrections
Type
array
Description
Each adjustment, with field, method, the amount added and a reason: station-ewma (rule station-corrected, on the low the levels compare and on the ensemble, with the station, its distanceKm and elevationDifference in metres, the model, the days of history and the nights it applied to), colder-of-two (rule colder-of-two, amount 0, the nights judged on coldCaseLow) and yard-offset.
Name
partial
Type
array
Description
Sources that failed or do not cover the location: a model, previous-runs, ensemble, alerts, stations or station-observations.

Request

GET

/v2/weather/frost-risk

curl -G "https://verdantly-gardening-api.p.rapidapi.com/v2/weather/frost-risk" \
  --data-urlencode "zip=55401" \
  --data-urlencode "nights=2" \
  -H "X-RapidAPI-Host: verdantly-gardening-api.p.rapidapi.com" \
  -H "X-RapidAPI-Key: {apiKey}"

Response

{
  "data": {
    "location": {
      "zipcode": "55401",
      "city": "Minneapolis, MN · Hennepin Co.",
      "hardinessZone": "4b",
      "latitude": 44.98,
      "longitude": -93.27,
      "timezone": "America/Chicago",
      "elevation": 257
    },
    "thresholds": [
      36,
      32,
      28
    ],
    "yardOffset": 0,
    "nights": [
      {
        "date": "2026-10-24",
        "start": "2026-10-24T18:00:00-05:00",
        "end": "2026-10-25T10:00:00-05:00",
        "low": 48.3,
        "coldCaseLow": 44.6,
        "trend": {
          "previousLow": 48.5,
          "change": -0.2
        },
        "ensemble": {
          "members": 31,
          "p10": 48.8,
          "p50": 50.9,
          "p90": 53.3
        },
        "alerts": [],
        "level": "none",
        "risk": [
          {
            "threshold": 36,
            "level": "none",
            "membersAtOrBelow": 0
          },
          {
            "threshold": 32,
            "level": "none",
            "membersAtOrBelow": 0
          },
          {
            "threshold": 28,
            "level": "none",
            "membersAtOrBelow": 0
          }
        ]
      }
    ]
  },
  "meta": {
    "version": "v2",
    "generatedAt": "2026-10-24T15:23:00.000Z",
    "units": {
      "temperature": "°F"
    },
    "attribution": {
      "text": "Weather data by Open-Meteo.com",
      "url": "https://open-meteo.com/",
      "licence": "CC BY 4.0",
      "licenceUrl": "https://creativecommons.org/licenses/by/4.0/",
      "changes": "Summarised into night lows (18:00 to 10:00 local), combined from several weather models, corrected by a nearby station’s recent forecast errors where one qualifies, and compared with frost thresholds by Verdantly."
    },
    "sources": [
      {
        "name": "Open-Meteo",
        "apis": [
          "forecast",
          "previous-runs",
          "ensemble"
        ]
      },
      {
        "name": "National Weather Service",
        "apis": [
          "alerts",
          "stations"
        ],
        "url": "https://api.weather.gov"
      },
      {
        "name": "NOAA Regional Climate Centers (ACIS)",
        "apis": [
          "StnData"
        ],
        "url": "https://data.rcc-acis.org/StnData"
      }
    ],
    "models": {
      "low": [
        "ncep_nbm_conus"
      ],
      "coldCase": [
        "ncep_nbm_conus",
        "best_match"
      ],
      "trend": [
        "ncep_nbm_conus"
      ],
      "ensemble": [
        "ncep_gefs025"
      ]
    },
    "corrections": [
      {
        "field": "nights[].risk",
        "method": "station-ewma",
        "rule": "station-corrected",
        "amount": -0.8,
        "reason": "KMSP's recent errors: ncep_nbm_conus lows ran 0.8° warm there (weighted average of 60 days); the levels compare the corrected low",
        "model": "ncep_nbm_conus",
        "station": "KMSP",
        "distanceKm": 11.3,
        "elevationDifference": -1,
        "days": 60,
        "nights": [
          "2026-10-24",
          "2026-10-25"
        ]
      },
      {
        "field": "nights[].ensemble",
        "method": "station-ewma",
        "rule": "station-corrected",
        "amount": -0.8,
        "reason": "Every ensemble member shifted by the same KMSP correction as the ncep_nbm_conus low before counting",
        "model": "ncep_nbm_conus",
        "station": "KMSP",
        "distanceKm": 11.3,
        "elevationDifference": -1,
        "days": 60,
        "nights": [
          "2026-10-24",
          "2026-10-25"
        ]
      }
    ],
    "partial": []
  }
}

The example is truncated to the first night, and meta.units to the temperature.

GET/v2/weather/zipcode/:zip

Get weather by ZIP code

Retrieve current weather conditions, the next 24 hours and a 7-day forecast for the given US ZIP code. The response includes the resolved location (city, hardiness zone) alongside the weather.

Weather data by Open-Meteo.com (CC BY 4.0). Every response carries a credit object: show its text, linked to its url, beside any weather you display.

Required attributes

Name
zip
Type
string
Description
US ZIP code (e.g., "90210").

Response: top level

Name
location
Type
object
Description
zipcode, city, latitude, longitude, hardinessZone.
Name
lat
Type
string
Description
Latitude of the forecast point (e.g., "35.77N"). lon is the longitude (e.g., "78.63W").
Name
elevation
Type
integer
Description
Elevation of the forecast grid cell in feet.
Name
timezone
Type
string
Description
IANA timezone of the location; all times are local to it.
Name
units
Type
string
Description
Always "us": °F, mph and inches of precipitation.
Name
current
Type
object
Description
Current conditions (below).
Name
hourly
Type
object
Description
data: 24 hourly entries from the current local hour (below).
Name
daily
Type
object
Description
data: 7 daily entries from today (below).
Name
credit
Type
object
Description
text ("Weather data by Open-Meteo.com"), url ("https://open-meteo.com/"), license ("CC BY 4.0").

Response: current conditions

Name
icon
Type
string
Description
Weather icon identifier (e.g., "partly_sunny", or "clear" at night).
Name
iconNum
Type
integer
Description
Numeric icon code, 1–36 (e.g., 2 sunny, 4 partly sunny, 11 rain, 26 clear night; 1 when the condition is not available).
Name
summary
Type
string
Description
Plain-language condition from the WMO weather code (e.g., "Partly cloudy").
Name
temperature
Type
number
Description
Current temperature in Fahrenheit.
Name
wind
Type
object
Description
Wind conditions: speed (mph), angle (degrees), dir (16-point compass direction, e.g., "SW"), gusts (mph).
Name
precipitation
Type
object
Description
Precipitation in the last 15 minutes: total (inches), type ("none", "rain", "snow" or "rain_snow").
Name
cloudCover
Type
number
Description
Cloud cover percentage (0-100).
Name
feelsLike
Type
number
Description
Apparent temperature in Fahrenheit.
Name
humidity
Type
number
Description
Relative humidity percentage.
Name
uvIndex
Type
number
Description
UV index value.
Name
dewPoint
Type
number
Description
Dew point in Fahrenheit.
Name
soilTemperature
Type
number
Description
Soil surface temperature in Fahrenheit.
Name
pressure
Type
number
Description
Sea-level atmospheric pressure in hPa (millibars).
Name
visibility
Type
number
Description
Visibility in meters.
Name
snowDepth
Type
number
Description
Snow depth in centimeters.
Name
probability
Type
object
Description
Precipitation probability: precipitation (percentage).

Response: hourly entries

Each entry in hourly.data contains date (local, YYYY-MM-DDTHH:00:00), weather (icon identifier), icon (numeric icon code), summary, temperature, wind (speed, dir, angle), cloudCover (total) and precipitation (total, type) for that hour.

Response: daily entries

Each entry in daily.data contains:

Name
day
Type
string
Description
Date in YYYY-MM-DD format.
Name
weather
Type
string
Description
Weather icon identifier for the day (e.g., "overcast").
Name
icon
Type
integer
Description
Numeric icon code for the day. Daily conditions are the most severe expected that day, so a clear day with a cloudy spell reads overcast.
Name
summary
Type
string
Description
Daily summary: the condition, low/high temperature, and precipitation when any is expected (e.g., "Light rain. Temperature 52/66 °F. Precipitation 0.3 in.").
Name
allDay
Type
object
Description
All-day aggregate: weather, icon, temperature (average of the day's hours), temperatureMin, temperatureMax, wind (speed average of the day's hours, dir and angle of the dominant direction), cloudCover (total, average of the day's hours), precipitation (total in inches, type).
Name
morning
Type
null
Description
Always null, as are afternoon and evening: day-part forecasts are not available.

Fields that are never returned

probability.freeze and probability.storm are not available from the weather source, so probability holds only precipitation. Any other value the source does not return for a location is left out of the response rather than estimated.

Request

GET

/v2/weather/zipcode/:zip

curl "https://verdantly-gardening-api.p.rapidapi.com/v2/weather/zipcode/90210" \
  -H "X-RapidAPI-Host: verdantly-gardening-api.p.rapidapi.com" \
  -H "X-RapidAPI-Key: {apiKey}"

Response

{
  "data": {
    "location": {
      "zipcode": "27601",
      "city": "Raleigh, NC · Wake Co.",
      "latitude": 35.774451,
      "longitude": -78.63274,
      "hardinessZone": "8a"
    },
    "lat": "35.77N",
    "lon": "78.63W",
    "elevation": 295,
    "timezone": "America/New_York",
    "units": "us",
    "current": {
      "icon": "sunny",
      "iconNum": 2,
      "summary": "Clear sky",
      "temperature": 70.6,
      "wind": {
        "speed": 8.1,
        "angle": 9,
        "dir": "N",
        "gusts": 13
      },
      "precipitation": {
        "total": 0,
        "type": "none"
      },
      "cloudCover": 0,
      "feelsLike": 64.4,
      "humidity": 27,
      "uvIndex": 4.1,
      "dewPoint": 35,
      "soilTemperature": 72.4,
      "pressure": 1017.4,
      "visibility": 66900,
      "snowDepth": 0,
      "probability": {
        "precipitation": 0
      }
    },
    "hourly": {
      "data": [
        {
          "date": "2026-10-22T15:00:00",
          "weather": "sunny",
          "icon": 2,
          "summary": "Clear sky",
          "temperature": 70.6,
          "wind": { "speed": 8.1, "dir": "N", "angle": 9 },
          "cloudCover": { "total": 0 },
          "precipitation": { "total": 0, "type": "none" }
        }
      ]
    },
    "daily": {
      "data": [
        {
          "day": "2026-10-23",
          "weather": "mostly_sunny",
          "icon": 3,
          "summary": "Mainly clear. Temperature 44/68 °F.",
          "allDay": {
            "weather": "mostly_sunny",
            "icon": 3,
            "temperature": 55.8,
            "temperatureMin": 43.9,
            "temperatureMax": 68.2,
            "wind": {
              "speed": 7.7,
              "dir": "NNE",
              "angle": 32
            },
            "cloudCover": { "total": 5.2 },
            "precipitation": { "total": 0, "type": "none" }
          },
          "morning": null,
          "afternoon": null,
          "evening": null
        }
      ]
    },
    "credit": {
      "text": "Weather data by Open-Meteo.com",
      "url": "https://open-meteo.com/",
      "license": "CC BY 4.0"
    }
  }
}

hourly.data holds 24 entries and daily.data 7; the example above is truncated to one of each for brevity.

GET/v2/weather/coordinates

Get weather by coordinates

Retrieve current weather conditions, the next 24 hours and a 7-day forecast for the given latitude and longitude. Returns the same weather data, credit included, as the ZIP code endpoint, but the location object holds only latitude and longitude (no zipcode, city, or hardinessZone).

Required attributes

Name
lat
Type
number
Description
Latitude (e.g., 35.78).
Name
lon
Type
number
Description
Longitude (e.g., -78.64).

Request

GET

/v2/weather/coordinates

curl -G "https://verdantly-gardening-api.p.rapidapi.com/v2/weather/coordinates" \
  --data-urlencode "lat=35.78" \
  --data-urlencode "lon=-78.64" \
  -H "X-RapidAPI-Host: verdantly-gardening-api.p.rapidapi.com" \
  -H "X-RapidAPI-Key: {apiKey}"

Response

{
  "data": {
    "location": {
      "latitude": 35.78,
      "longitude": -78.64
    },
    "lat": "35.78N",
    "lon": "78.64W",
    "elevation": 295,
    "timezone": "America/New_York",
    "units": "us",
    "current": {
      "icon": "sunny",
      "iconNum": 2,
      "summary": "Clear sky",
      "temperature": 70.6,
      "wind": { "speed": 8.1, "angle": 9, "dir": "N", "gusts": 13 },
      "precipitation": { "total": 0, "type": "none" },
      "cloudCover": 0,
      "feelsLike": 64.4,
      "humidity": 27,
      "uvIndex": 4.1,
      "dewPoint": 35,
      "soilTemperature": 72.4,
      "pressure": 1017.4,
      "visibility": 66900,
      "snowDepth": 0,
      "probability": { "precipitation": 0 }
    },
    "hourly": { "data": [] },
    "daily": { "data": [] },
    "credit": {
      "text": "Weather data by Open-Meteo.com",
      "url": "https://open-meteo.com/",
      "license": "CC BY 4.0"
    }
  }
}

hourly.data and daily.data are emptied in this example for brevity; they hold the same 24 hourly and 7 daily entries as the ZIP code endpoint. The coordinate endpoint does not resolve location metadata (ZIP code, city, hardiness zone). Use the ZIP code endpoint if you need location context alongside weather data.

GET/v2/frost-dates/zipcode/:zip

Get frost dates

Look up last spring frost and first fall frost dates for a US ZIP code, from NOAA U.S. Climate Normals 1991-2020 at a nearby weather station. The dates are 32°F at 30% probability: a 3 in 10 chance of frost after the spring date or before the fall date. They are essential for calculating planting windows and growing season length.

Frost dates: NOAA National Centers for Environmental Information, U.S. Climate Normals 1991-2020 (doi:10.25921/4ek7-fk11).

Required attributes

Name
zip
Type
string
Description
US ZIP code (e.g., "06101").

Response properties

Name
zipcode
Type
string
Description
The ZIP code that was looked up.
Name
lastSpringFrost
Type
object | null
Description
Last spring frost date, with about a 30% chance of a 32°F frost after it: month (number, 1-12), day (number), julianDay (number), display (formatted string, e.g., "April 15"). null when frostStatus is "frost-free" or "unknown".
Name
firstFallFrost
Type
object | null
Description
First fall frost date, with about a 30% chance of a 32°F frost before it: month (number, 1-12), day (number), julianDay (number), display (formatted string, e.g., "October 15"). null when frostStatus is "frost-free" or "unknown".
Name
growingSeasonDays
Type
integer | null
Description
Number of frost-free days between the last spring frost and first fall frost.
Name
frostStatus
Type
string
Description
How to read null dates. "dates": at least one frost date is known. "frost-free": no frost dates are expected, because a 32°F night is too rare at the station to date (or, without a station, the ZIP is in hardiness zone 10 or warmer). "unknown": there are no frost dates for this ZIP code (not a frost-free claim).

Optional attribution properties

Present when the response names its station (source is "noaa"). Treat any of them as optional.

Name
source
Type
string
Description
"noaa".
Name
citation
Type
string
Description
The credit line to show with the dates.
Name
probabilityPct
Type
number
Description
Chance (%) of frost after the spring date or before the fall date: 30.
Name
thresholdF
Type
number
Description
Frost threshold in °F: 32.
Name
station
Type
object
Description
The station the dates are measured at: id, name, distanceMi from the ZIP code, elevationFt, elevationDeltaFt (station minus ZIP code, or null), and its own lastSpringFrost and firstFallFrost.
Name
freezeYearsPct
Type
number | null
Description
Share of years (%) with a 32°F night at the station. Below 90, frost does not come every year.
Name
confidence
Type
string | null
Description
How well the station stands in for the ZIP code: "high", "medium" or "low", from its distance, elevation difference and agreement with the next station.
Name
stationOverride
Type
object
Description
Present when a local source's station is used instead of the nearest one: organization, title, url.
Name
secondStation
Type
object
Description
Present when a station within 15 miles differs by more than 7 days: the later spring and earlier fall of the two are served. Same fields as station, plus freezeYearsPct and servedFor (the seasons whose date is this station's).
Name
normals
Type
object
Description
Every freeze normal at the station, keyed by threshold in °F ("16" to "36"): freezeYearsPct, and lastSpring, firstFall ("MM-DD") and seasonDays at 10, 20 ... 90%. A value is "rare" when freezes are too few to compute it, "year-round" when a freeze is possible in every month, or null.

Request

GET

/v2/frost-dates/zipcode/:zip

curl "https://verdantly-gardening-api.p.rapidapi.com/v2/frost-dates/zipcode/06101" \
  -H "X-RapidAPI-Host: verdantly-gardening-api.p.rapidapi.com" \
  -H "X-RapidAPI-Key: {apiKey}"

Response

{
  "data": {
    "zipcode": "06101",
    "lastSpringFrost": {
      "month": 4,
      "day": 22,
      "julianDay": 112,
      "display": "April 22"
    },
    "firstFallFrost": {
      "month": 10,
      "day": 10,
      "julianDay": 283,
      "display": "October 10"
    },
    "growingSeasonDays": 171,
    "frostStatus": "dates"
  }
}

GET/v2/hardiness-zones/zipcode/:zipcode

Get hardiness zone

Look up the USDA plant hardiness zone for a US ZIP code. Returns the zone designation, temperature range, and resolved coordinates for the location.

Required attributes

Name
zipcode
Type
string
Description
US ZIP code (e.g., "90210").

Response properties

Name
zipcode
Type
string
Description
The ZIP code that was looked up.
Name
zone
Type
string
Description
USDA hardiness zone designation (e.g., "10b").
Name
tempRange
Type
string
Description
Average annual minimum temperature range for the zone (e.g., "35 to 40 °F").
Name
zoneTitle
Type
string
Description
Full zone title (e.g., "Zone 10b: 35 to 40 °F").
Name
latitude
Type
number
Description
Latitude of the ZIP code centroid.
Name
longitude
Type
number
Description
Longitude of the ZIP code centroid.
Name
city
Type
string
Description
City name resolved from the ZIP code.

Request

GET

/v2/hardiness-zones/zipcode/:zipcode

curl "https://verdantly-gardening-api.p.rapidapi.com/v2/hardiness-zones/zipcode/90210" \
  -H "X-RapidAPI-Host: verdantly-gardening-api.p.rapidapi.com" \
  -H "X-RapidAPI-Key: {apiKey}"

Response

{
  "data": {
    "zipcode": "90210",
    "zone": "10b",
    "tempRange": "35 to 40 °F",
    "zoneTitle": "Zone 10b: 35 to 40 °F",
    "latitude": 34.0901,
    "longitude": -118.4065,
    "city": "Beverly Hills"
  }
}

Weather, Frost & Zones

GET/v2/weather/forecast

Get garden forecast

Location (one of)

Name
zip
Type
string
Description
US ZIP code (e.g., "27601"). The response's location adds the city and hardiness zone.
Name
lat
Type
number
Description
Latitude, -90 to 90, with lon (-180 to 180).

Optional attributes

Name
units
Type
string
Description
us (default: °F, mph, inches) or metric (°C, km/h, mm; snowfall in cm). meta.units names the unit of every kind of value.
Name
days
Type
integer
Description
Days of daily forecast from today at the location, 1 to 16. Default 7.
Name
hours
Type
integer
Description
Hours of hourly forecast from the start of the current hour, 0 to 48. Default 24.

Response: data

Name
location
Type
object
Description
zipcode, city, hardinessZone (null for a coordinate request), latitude, longitude, timezone (IANA).
Name
current
Type
object
Description
time, temperature, apparentTemperature, relativeHumidity, dewPoint, weatherCode (WMO), condition (its description), isDay, cloudCover, precipitation (preceding 15 minutes), wind (speed, direction in degrees, gusts), uvIndex, soilTemperature (surface, depth6cm).
Name
hourly
Type
array
Description
One entry per hour: time, temperature, apparentTemperature, relativeHumidity, dewPoint, precipitation, precipitationProbability, weatherCode, condition, windSpeed, windGusts, uvIndex, isDay, vapourPressureDeficit (kPa).
Name
daily
Type
array
Description
One entry per day: date, weatherCode, condition, temperatureMax, temperatureMin, precipitation, precipitationProbabilityMax, precipitationHours, snowfall, windSpeedMax, windGustsMax, windDirectionDominant, uvIndexMax, sunrise, sunset, daylightDuration and sunshineDuration (seconds), shortwaveRadiation (MJ/m²), et0, vapourPressureDeficitMax (kPa).

Times are ISO 8601 with the UTC offset in force at that moment; date is the calendar date at the location. A value the weather source did not return is null, never estimated.

Response: meta

Name
units
Type
object
Description
Unit of each kind of value (temperature covers air, feels-like, dew point and soil).
Name
attribution
Type
object
Description
text, url, licence, licenceUrl, and changes: what Verdantly changed, as the licence requires.
Name
models
Type
object
Description
temperature, precipitation and other: the models that supplied each group, first choice first.
Name
partial
Type
array
Description
Sources that failed (for example ncep_nbm_conus); the response was answered without them.

Request

GET

/v2/weather/forecast

curl -G "https://verdantly-gardening-api.p.rapidapi.com/v2/weather/forecast" \
  --data-urlencode "zip=27601" \
  --data-urlencode "days=7" \
  -H "X-RapidAPI-Host: verdantly-gardening-api.p.rapidapi.com" \
  -H "X-RapidAPI-Key: {apiKey}"

Response

{
  "data": {
    "location": {
      "zipcode": "27601",
      "city": "Raleigh, NC · Wake Co.",
      "hardinessZone": "8a",
      "latitude": 35.774451,
      "longitude": -78.63274,
      "timezone": "America/New_York"
    },
    "current": {
      "time": "2026-10-23T00:30:00-04:00",
      "temperature": 42.7,
      "apparentTemperature": 38.4,
      "relativeHumidity": 72,
      "dewPoint": 34.3,
      "weatherCode": 0,
      "condition": "Clear sky",
      "isDay": false,
      "cloudCover": 0,
      "precipitation": 0,
      "wind": {
        "speed": 1.8,
        "direction": 5,
        "gusts": 4.3
      },
      "uvIndex": 0,
      "soilTemperature": {
        "surface": 32.4,
        "depth6cm": 49.4
      }
    },
    "hourly": [
      {
        "time": "2026-10-23T00:00:00-04:00",
        "temperature": 48.7,
        "apparentTemperature": 44.4,
        "relativeHumidity": 63,
        "dewPoint": 36.6,
        "precipitation": 0,
        "precipitationProbability": 0,
        "weatherCode": 0,
        "condition": "Clear sky",
        "windSpeed": 2.7,
        "windGusts": 6.9,
        "uvIndex": 0,
        "isDay": false,
        "vapourPressureDeficit": 0.28
      }
    ],
    "daily": [
      {
        "date": "2026-10-23",
        "weatherCode": 3,
        "condition": "Overcast",
        "temperatureMax": 68.8,
        "temperatureMin": 44.1,
        "precipitation": 0,
        "precipitationProbabilityMax": 0,
        "precipitationHours": 0,
        "snowfall": 0,
        "windSpeedMax": 9.8,
        "windGustsMax": 25.7,
        "windDirectionDominant": 23,
        "uvIndexMax": 4.95,
        "sunrise": "2026-10-23T07:28:23-04:00",
        "sunset": "2026-10-23T18:28:48-04:00",
        "daylightDuration": 39633.69,
        "sunshineDuration": 36000,
        "shortwaveRadiation": 16.62,
        "et0": 0.131,
        "vapourPressureDeficitMax": 1.54
      }
    ]
  },
  "meta": {
    "version": "v2",
    "generatedAt": "2026-10-23T04:32:07.378Z",
    "units": {
      "temperature": "°F",
      "precipitation": "in",
      "et0": "in",
      "snowfall": "in",
      "windSpeed": "mph",
      "vapourPressureDeficit": "kPa"
    },
    "attribution": {
      "text": "Weather data by Open-Meteo.com",
      "url": "https://open-meteo.com/",
      "licence": "CC BY 4.0",
      "licenceUrl": "https://creativecommons.org/licenses/by/4.0/",
      "changes": "Arranged into rows by time and combined from several weather models (see meta.models) by Verdantly."
    },
    "sources": [
      {
        "name": "Open-Meteo",
        "apis": [
          "forecast"
        ]
      }
    ],
    "models": {
      "temperature": [
        "ncep_nbm_conus"
      ],
      "precipitation": [
        "ncep_nbm_conus"
      ],
      "other": [
        "best_match"
      ]
    },
    "corrections": [],
    "partial": []
  }
}

The example is truncated to one hourly and one daily entry for brevity.

GET/v2/weather/frost-risk

Get frost risk

Location (one of)

Name
zip
Type
string
Description
US ZIP code (e.g., "55401").
Name
lat
Type
number
Description
Latitude, -90 to 90, with lon (-180 to 180).

Optional attributes

Name
units
Type
string
Description
us (default: °F) or metric (°C).
Name
nights
Type
integer
Description
Nights from this evening, 1 to 10. Default 7.
Name
thresholds
Type
string
Description
Up to 5 comma-separated temperatures in the response unit. Default 36,32,28 (°F) or 2,0,-2 (°C).
Name
yardOffset
Type
number
Description
Degrees the garden runs colder than the forecast, 0 to 15. Default 0.

This route allows 10 requests per 10 seconds and 60 per minute.

Response: data

Name
location
Type
object
Description
As for the forecast, plus elevation (metres) of the forecast point.
Name
nights
Type
array
Description
One entry per night: date (the evening's), start, end, low (Blend in the contiguous US, else best_match), coldCaseLow, trend (previousLow, change; null past 7 days of earlier runs), ensemble (members, p10, p50, p90; null past the ensemble's 10 days), alerts (NWS ids), level, and risk (per threshold: threshold, level, membersAtOrBelow).

Response: meta

Name
models
Type
object
Description
low, coldCase, trend and ensemble: the models used.
Name
corrections
Type
array
Description
Each adjustment, with field, method, the amount added and a reason: station-ewma (rule station-corrected, on the low the levels compare and on the ensemble, with the station, its distanceKm and elevationDifference in metres, the model, the days of history and the nights it applied to), colder-of-two (rule colder-of-two, amount 0, the nights judged on coldCaseLow) and yard-offset.
Name
partial
Type
array
Description
Sources that failed or do not cover the location: a model, previous-runs, ensemble, alerts, stations or station-observations.

Request

GET

/v2/weather/frost-risk

curl -G "https://verdantly-gardening-api.p.rapidapi.com/v2/weather/frost-risk" \
  --data-urlencode "zip=55401" \
  --data-urlencode "nights=2" \
  -H "X-RapidAPI-Host: verdantly-gardening-api.p.rapidapi.com" \
  -H "X-RapidAPI-Key: {apiKey}"

Response

{
  "data": {
    "location": {
      "zipcode": "55401",
      "city": "Minneapolis, MN · Hennepin Co.",
      "hardinessZone": "4b",
      "latitude": 44.98,
      "longitude": -93.27,
      "timezone": "America/Chicago",
      "elevation": 257
    },
    "thresholds": [
      36,
      32,
      28
    ],
    "yardOffset": 0,
    "nights": [
      {
        "date": "2026-10-24",
        "start": "2026-10-24T18:00:00-05:00",
        "end": "2026-10-25T10:00:00-05:00",
        "low": 48.3,
        "coldCaseLow": 44.6,
        "trend": {
          "previousLow": 48.5,
          "change": -0.2
        },
        "ensemble": {
          "members": 31,
          "p10": 48.8,
          "p50": 50.9,
          "p90": 53.3
        },
        "alerts": [],
        "level": "none",
        "risk": [
          {
            "threshold": 36,
            "level": "none",
            "membersAtOrBelow": 0
          },
          {
            "threshold": 32,
            "level": "none",
            "membersAtOrBelow": 0
          },
          {
            "threshold": 28,
            "level": "none",
            "membersAtOrBelow": 0
          }
        ]
      }
    ]
  },
  "meta": {
    "version": "v2",
    "generatedAt": "2026-10-24T15:23:00.000Z",
    "units": {
      "temperature": "°F"
    },
    "attribution": {
      "text": "Weather data by Open-Meteo.com",
      "url": "https://open-meteo.com/",
      "licence": "CC BY 4.0",
      "licenceUrl": "https://creativecommons.org/licenses/by/4.0/",
      "changes": "Summarised into night lows (18:00 to 10:00 local), combined from several weather models, corrected by a nearby station’s recent forecast errors where one qualifies, and compared with frost thresholds by Verdantly."
    },
    "sources": [
      {
        "name": "Open-Meteo",
        "apis": [
          "forecast",
          "previous-runs",
          "ensemble"
        ]
      },
      {
        "name": "National Weather Service",
        "apis": [
          "alerts",
          "stations"
        ],
        "url": "https://api.weather.gov"
      },
      {
        "name": "NOAA Regional Climate Centers (ACIS)",
        "apis": [
          "StnData"
        ],
        "url": "https://data.rcc-acis.org/StnData"
      }
    ],
    "models": {
      "low": [
        "ncep_nbm_conus"
      ],
      "coldCase": [
        "ncep_nbm_conus",
        "best_match"
      ],
      "trend": [
        "ncep_nbm_conus"
      ],
      "ensemble": [
        "ncep_gefs025"
      ]
    },
    "corrections": [
      {
        "field": "nights[].risk",
        "method": "station-ewma",
        "rule": "station-corrected",
        "amount": -0.8,
        "reason": "KMSP's recent errors: ncep_nbm_conus lows ran 0.8° warm there (weighted average of 60 days); the levels compare the corrected low",
        "model": "ncep_nbm_conus",
        "station": "KMSP",
        "distanceKm": 11.3,
        "elevationDifference": -1,
        "days": 60,
        "nights": [
          "2026-10-24",
          "2026-10-25"
        ]
      },
      {
        "field": "nights[].ensemble",
        "method": "station-ewma",
        "rule": "station-corrected",
        "amount": -0.8,
        "reason": "Every ensemble member shifted by the same KMSP correction as the ncep_nbm_conus low before counting",
        "model": "ncep_nbm_conus",
        "station": "KMSP",
        "distanceKm": 11.3,
        "elevationDifference": -1,
        "days": 60,
        "nights": [
          "2026-10-24",
          "2026-10-25"
        ]
      }
    ],
    "partial": []
  }
}

The example is truncated to the first night, and meta.units to the temperature.

GET/v2/weather/zipcode/:zip

Get weather by ZIP code

Retrieve current weather conditions, the next 24 hours and a 7-day forecast for the given US ZIP code. The response includes the resolved location (city, hardiness zone) alongside the weather.

Weather data by Open-Meteo.com (CC BY 4.0). Every response carries a credit object: show its text, linked to its url, beside any weather you display.

Required attributes

Name
zip
Type
string
Description
US ZIP code (e.g., "90210").

Response: top level

Name
location
Type
object
Description
zipcode, city, latitude, longitude, hardinessZone.
Name
lat
Type
string
Description
Latitude of the forecast point (e.g., "35.77N"). lon is the longitude (e.g., "78.63W").
Name
elevation
Type
integer
Description
Elevation of the forecast grid cell in feet.
Name
timezone
Type
string
Description
IANA timezone of the location; all times are local to it.
Name
units
Type
string
Description
Always "us": °F, mph and inches of precipitation.
Name
current
Type
object
Description
Current conditions (below).
Name
hourly
Type
object
Description
data: 24 hourly entries from the current local hour (below).
Name
daily
Type
object
Description
data: 7 daily entries from today (below).
Name
credit
Type
object
Description
text ("Weather data by Open-Meteo.com"), url ("https://open-meteo.com/"), license ("CC BY 4.0").

Response: current conditions

Name
icon
Type
string
Description
Weather icon identifier (e.g., "partly_sunny", or "clear" at night).
Name
iconNum
Type
integer
Description
Numeric icon code, 1–36 (e.g., 2 sunny, 4 partly sunny, 11 rain, 26 clear night; 1 when the condition is not available).
Name
summary
Type
string
Description
Plain-language condition from the WMO weather code (e.g., "Partly cloudy").
Name
temperature
Type
number
Description
Current temperature in Fahrenheit.
Name
wind
Type
object
Description
Wind conditions: speed (mph), angle (degrees), dir (16-point compass direction, e.g., "SW"), gusts (mph).
Name
precipitation
Type
object
Description
Precipitation in the last 15 minutes: total (inches), type ("none", "rain", "snow" or "rain_snow").
Name
cloudCover
Type
number
Description
Cloud cover percentage (0-100).
Name
feelsLike
Type
number
Description
Apparent temperature in Fahrenheit.
Name
humidity
Type
number
Description
Relative humidity percentage.
Name
uvIndex
Type
number
Description
UV index value.
Name
dewPoint
Type
number
Description
Dew point in Fahrenheit.
Name
soilTemperature
Type
number
Description
Soil surface temperature in Fahrenheit.
Name
pressure
Type
number
Description
Sea-level atmospheric pressure in hPa (millibars).
Name
visibility
Type
number
Description
Visibility in meters.
Name
snowDepth
Type
number
Description
Snow depth in centimeters.
Name
probability
Type
object
Description
Precipitation probability: precipitation (percentage).

Response: hourly entries

Response: daily entries

Each entry in daily.data contains:

Name
day
Type
string
Description
Date in YYYY-MM-DD format.
Name
weather
Type
string
Description
Weather icon identifier for the day (e.g., "overcast").
Name
icon
Type
integer
Description
Numeric icon code for the day. Daily conditions are the most severe expected that day, so a clear day with a cloudy spell reads overcast.
Name
summary
Type
string
Description
Daily summary: the condition, low/high temperature, and precipitation when any is expected (e.g., "Light rain. Temperature 52/66 °F. Precipitation 0.3 in.").
Name
allDay
Type
object
Description
All-day aggregate: weather, icon, temperature (average of the day's hours), temperatureMin, temperatureMax, wind (speed average of the day's hours, dir and angle of the dominant direction), cloudCover (total, average of the day's hours), precipitation (total in inches, type).
Name
morning
Type
null
Description
Always null, as are afternoon and evening: day-part forecasts are not available.

Fields that are never returned

Request

GET

/v2/weather/zipcode/:zip

curl "https://verdantly-gardening-api.p.rapidapi.com/v2/weather/zipcode/90210" \
  -H "X-RapidAPI-Host: verdantly-gardening-api.p.rapidapi.com" \
  -H "X-RapidAPI-Key: {apiKey}"

Response

{
  "data": {
    "location": {
      "zipcode": "27601",
      "city": "Raleigh, NC · Wake Co.",
      "latitude": 35.774451,
      "longitude": -78.63274,
      "hardinessZone": "8a"
    },
    "lat": "35.77N",
    "lon": "78.63W",
    "elevation": 295,
    "timezone": "America/New_York",
    "units": "us",
    "current": {
      "icon": "sunny",
      "iconNum": 2,
      "summary": "Clear sky",
      "temperature": 70.6,
      "wind": {
        "speed": 8.1,
        "angle": 9,
        "dir": "N",
        "gusts": 13
      },
      "precipitation": {
        "total": 0,
        "type": "none"
      },
      "cloudCover": 0,
      "feelsLike": 64.4,
      "humidity": 27,
      "uvIndex": 4.1,
      "dewPoint": 35,
      "soilTemperature": 72.4,
      "pressure": 1017.4,
      "visibility": 66900,
      "snowDepth": 0,
      "probability": {
        "precipitation": 0
      }
    },
    "hourly": {
      "data": [
        {
          "date": "2026-10-22T15:00:00",
          "weather": "sunny",
          "icon": 2,
          "summary": "Clear sky",
          "temperature": 70.6,
          "wind": { "speed": 8.1, "dir": "N", "angle": 9 },
          "cloudCover": { "total": 0 },
          "precipitation": { "total": 0, "type": "none" }
        }
      ]
    },
    "daily": {
      "data": [
        {
          "day": "2026-10-23",
          "weather": "mostly_sunny",
          "icon": 3,
          "summary": "Mainly clear. Temperature 44/68 °F.",
          "allDay": {
            "weather": "mostly_sunny",
            "icon": 3,
            "temperature": 55.8,
            "temperatureMin": 43.9,
            "temperatureMax": 68.2,
            "wind": {
              "speed": 7.7,
              "dir": "NNE",
              "angle": 32
            },
            "cloudCover": { "total": 5.2 },
            "precipitation": { "total": 0, "type": "none" }
          },
          "morning": null,
          "afternoon": null,
          "evening": null
        }
      ]
    },
    "credit": {
      "text": "Weather data by Open-Meteo.com",
      "url": "https://open-meteo.com/",
      "license": "CC BY 4.0"
    }
  }
}

hourly.data holds 24 entries and daily.data 7; the example above is truncated to one of each for brevity.

GET/v2/weather/coordinates

Get weather by coordinates

Required attributes

Name
lat
Type
number
Description
Latitude (e.g., 35.78).
Name
lon
Type
number
Description
Longitude (e.g., -78.64).

Request

GET

/v2/weather/coordinates

curl -G "https://verdantly-gardening-api.p.rapidapi.com/v2/weather/coordinates" \
  --data-urlencode "lat=35.78" \
  --data-urlencode "lon=-78.64" \
  -H "X-RapidAPI-Host: verdantly-gardening-api.p.rapidapi.com" \
  -H "X-RapidAPI-Key: {apiKey}"

Response

{
  "data": {
    "location": {
      "latitude": 35.78,
      "longitude": -78.64
    },
    "lat": "35.78N",
    "lon": "78.64W",
    "elevation": 295,
    "timezone": "America/New_York",
    "units": "us",
    "current": {
      "icon": "sunny",
      "iconNum": 2,
      "summary": "Clear sky",
      "temperature": 70.6,
      "wind": { "speed": 8.1, "angle": 9, "dir": "N", "gusts": 13 },
      "precipitation": { "total": 0, "type": "none" },
      "cloudCover": 0,
      "feelsLike": 64.4,
      "humidity": 27,
      "uvIndex": 4.1,
      "dewPoint": 35,
      "soilTemperature": 72.4,
      "pressure": 1017.4,
      "visibility": 66900,
      "snowDepth": 0,
      "probability": { "precipitation": 0 }
    },
    "hourly": { "data": [] },
    "daily": { "data": [] },
    "credit": {
      "text": "Weather data by Open-Meteo.com",
      "url": "https://open-meteo.com/",
      "license": "CC BY 4.0"
    }
  }
}

GET/v2/frost-dates/zipcode/:zip

Get frost dates

Frost dates: NOAA National Centers for Environmental Information, U.S. Climate Normals 1991-2020 (doi:10.25921/4ek7-fk11).

Required attributes

Name
zip
Type
string
Description
US ZIP code (e.g., "06101").

Response properties

Name
zipcode
Type
string
Description
The ZIP code that was looked up.
Name
lastSpringFrost
Type
object | null
Description
Last spring frost date, with about a 30% chance of a 32°F frost after it: month (number, 1-12), day (number), julianDay (number), display (formatted string, e.g., "April 15"). null when frostStatus is "frost-free" or "unknown".
Name
firstFallFrost
Type
object | null
Description
First fall frost date, with about a 30% chance of a 32°F frost before it: month (number, 1-12), day (number), julianDay (number), display (formatted string, e.g., "October 15"). null when frostStatus is "frost-free" or "unknown".
Name
growingSeasonDays
Type
integer | null
Description
Number of frost-free days between the last spring frost and first fall frost.
Name
frostStatus
Type
string
Description
How to read null dates. "dates": at least one frost date is known. "frost-free": no frost dates are expected, because a 32°F night is too rare at the station to date (or, without a station, the ZIP is in hardiness zone 10 or warmer). "unknown": there are no frost dates for this ZIP code (not a frost-free claim).

Optional attribution properties

Present when the response names its station (source is "noaa"). Treat any of them as optional.

Name
source
Type
string
Description
"noaa".
Name
citation
Type
string
Description
The credit line to show with the dates.
Name
probabilityPct
Type
number
Description
Chance (%) of frost after the spring date or before the fall date: 30.
Name
thresholdF
Type
number
Description
Frost threshold in °F: 32.
Name
station
Type
object
Description
The station the dates are measured at: id, name, distanceMi from the ZIP code, elevationFt, elevationDeltaFt (station minus ZIP code, or null), and its own lastSpringFrost and firstFallFrost.
Name
freezeYearsPct
Type
number | null
Description
Share of years (%) with a 32°F night at the station. Below 90, frost does not come every year.
Name
confidence
Type
string | null
Description
How well the station stands in for the ZIP code: "high", "medium" or "low", from its distance, elevation difference and agreement with the next station.
Name
stationOverride
Type
object
Description
Present when a local source's station is used instead of the nearest one: organization, title, url.
Name
secondStation
Type
object
Description
Present when a station within 15 miles differs by more than 7 days: the later spring and earlier fall of the two are served. Same fields as station, plus freezeYearsPct and servedFor (the seasons whose date is this station's).
Name
normals
Type
object
Description
Every freeze normal at the station, keyed by threshold in °F ("16" to "36"): freezeYearsPct, and lastSpring, firstFall ("MM-DD") and seasonDays at 10, 20 ... 90%. A value is "rare" when freezes are too few to compute it, "year-round" when a freeze is possible in every month, or null.

Request

GET

/v2/frost-dates/zipcode/:zip

curl "https://verdantly-gardening-api.p.rapidapi.com/v2/frost-dates/zipcode/06101" \
  -H "X-RapidAPI-Host: verdantly-gardening-api.p.rapidapi.com" \
  -H "X-RapidAPI-Key: {apiKey}"

Response

{
  "data": {
    "zipcode": "06101",
    "lastSpringFrost": {
      "month": 4,
      "day": 22,
      "julianDay": 112,
      "display": "April 22"
    },
    "firstFallFrost": {
      "month": 10,
      "day": 10,
      "julianDay": 283,
      "display": "October 10"
    },
    "growingSeasonDays": 171,
    "frostStatus": "dates"
  }
}

GET/v2/hardiness-zones/zipcode/:zipcode

Get hardiness zone

Look up the USDA plant hardiness zone for a US ZIP code. Returns the zone designation, temperature range, and resolved coordinates for the location.

Required attributes

Name
zipcode
Type
string
Description
US ZIP code (e.g., "90210").

Response properties

Name
zipcode
Type
string
Description
The ZIP code that was looked up.
Name
zone
Type
string
Description
USDA hardiness zone designation (e.g., "10b").
Name
tempRange
Type
string
Description
Average annual minimum temperature range for the zone (e.g., "35 to 40 °F").
Name
zoneTitle
Type
string
Description
Full zone title (e.g., "Zone 10b: 35 to 40 °F").
Name
latitude
Type
number
Description
Latitude of the ZIP code centroid.
Name
longitude
Type
number
Description
Longitude of the ZIP code centroid.
Name
city
Type
string
Description
City name resolved from the ZIP code.

Request

GET

/v2/hardiness-zones/zipcode/:zipcode

curl "https://verdantly-gardening-api.p.rapidapi.com/v2/hardiness-zones/zipcode/90210" \
  -H "X-RapidAPI-Host: verdantly-gardening-api.p.rapidapi.com" \
  -H "X-RapidAPI-Key: {apiKey}"

Response

{
  "data": {
    "zipcode": "90210",
    "zone": "10b",
    "tempRange": "35 to 40 °F",
    "zoneTitle": "Zone 10b: 35 to 40 °F",
    "latitude": 34.0901,
    "longitude": -118.4065,
    "city": "Beverly Hills"
  }
}