Weather, Frost & Zones

Current conditions, 7-day forecasts, 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/zipcode/:zip

Get weather by ZIP code

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

Required attributes

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

Response: current conditions

Name
icon
Type
string
Description
Weather icon identifier (e.g., "partly_sunny").
Name
iconNum
Type
integer
Description
Numeric icon code.
Name
summary
Type
string
Description
Human-readable summary of current conditions (e.g., "Partly sunny").
Name
temperature
Type
number
Description
Current temperature in Fahrenheit.
Name
wind
Type
object
Description
Wind conditions: speed (mph), angle (degrees), dir (compass direction, e.g., "SW"), gusts (mph).
Name
precipitation
Type
object
Description
Precipitation data: total (inches), type (e.g., "rain", "none").
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
Atmospheric pressure in 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: daily forecast entries

Each entry in the daily array contains:

Name
day
Type
string
Description
Date in YYYY-MM-DD format.
Name
weather
Type
string
Description
Weather condition label.
Name
icon
Type
string
Description
Weather icon identifier.
Name
summary
Type
string
Description
Daily summary text.
Name
allDay
Type
object
Description
All-day aggregate: weather, icon, temperature (avg), temperatureMin, temperatureMax, wind (object), cloudCover, precipitation (object).

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": "90210",
      "city": "Beverly Hills",
      "hardinessZone": "10b"
    },
    "current": {
      "icon": "partly_sunny",
      "iconNum": 4,
      "summary": "Partly sunny",
      "temperature": 78.3,
      "wind": {
        "speed": 8.2,
        "angle": 225,
        "dir": "SW",
        "gusts": 14.6
      },
      "precipitation": {
        "total": 0,
        "type": "none"
      },
      "cloudCover": 35,
      "feelsLike": 76.1,
      "humidity": 52,
      "uvIndex": 7.4,
      "dewPoint": 58.9,
      "soilTemperature": 71.2,
      "pressure": 1015.3,
      "visibility": 16093,
      "snowDepth": 0,
      "probability": {
        "precipitation": 0
      }
    },
    "daily": [
      {
        "day": "2026-05-13",
        "weather": "Partly sunny",
        "icon": "partly_sunny",
        "summary": "Partly sunny skies with a light breeze. High of 82°F.",
        "allDay": {
          "weather": "Partly sunny",
          "icon": "partly_sunny",
          "temperature": 75.4,
          "temperatureMin": 62.1,
          "temperatureMax": 82.6,
          "wind": {
            "speed": 9.1,
            "angle": 240,
            "dir": "WSW",
            "gusts": 16.3
          },
          "cloudCover": 38,
          "precipitation": {
            "total": 0,
            "type": "none"
          }
        }
      },
      {
        "day": "2026-05-14",
        "weather": "Sunny",
        "icon": "sunny",
        "summary": "Clear and sunny. High of 85°F.",
        "allDay": {
          "weather": "Sunny",
          "icon": "sunny",
          "temperature": 77.8,
          "temperatureMin": 63.5,
          "temperatureMax": 85.2,
          "wind": {
            "speed": 6.4,
            "angle": 200,
            "dir": "SSW",
            "gusts": 11.8
          },
          "cloudCover": 12,
          "precipitation": {
            "total": 0,
            "type": "none"
          }
        }
      }
    ]
  }
}

The daily array contains up to 7 entries. The example above is truncated to 2 days for brevity.

GET/v2/weather/coordinates

Get weather by coordinates

Retrieve current weather conditions and a 7-day forecast for the given latitude and longitude. Returns the same weather data as the ZIP code endpoint, but the location object will not include 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": {
    "current": {
      "icon": "mostly_sunny",
      "iconNum": 3,
      "summary": "Mostly sunny",
      "temperature": 84.7,
      "wind": {
        "speed": 6.9,
        "angle": 190,
        "dir": "S",
        "gusts": 12.1
      },
      "precipitation": {
        "total": 0,
        "type": "none"
      },
      "cloudCover": 22,
      "feelsLike": 87.3,
      "humidity": 61,
      "uvIndex": 8.1,
      "dewPoint": 69.8,
      "soilTemperature": 74.5,
      "pressure": 1013.7,
      "visibility": 16093,
      "snowDepth": 0,
      "probability": {
        "precipitation": 5
      }
    },
    "daily": [
      {
        "day": "2026-05-13",
        "weather": "Mostly sunny",
        "icon": "mostly_sunny",
        "summary": "Mostly sunny with afternoon clouds. High near 88°F.",
        "allDay": {
          "weather": "Mostly sunny",
          "icon": "mostly_sunny",
          "temperature": 80.2,
          "temperatureMin": 66.4,
          "temperatureMax": 88.1,
          "wind": {
            "speed": 7.5,
            "angle": 185,
            "dir": "S",
            "gusts": 13.4
          },
          "cloudCover": 25,
          "precipitation": {
            "total": 0,
            "type": "none"
          }
        }
      }
    ]
  }
}

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 average last spring frost and first fall frost dates for a US ZIP code. These dates represent the 50% probability threshold and are essential for calculating planting windows and growing season length.

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
Description
Average last spring frost: month (number, 1-12), day (number), julianDay (number), display (formatted string, e.g., "April 15").
Name
firstFallFrost
Type
object
Description
Average first fall frost: month (number, 1-12), day (number), julianDay (number), display (formatted string, e.g., "October 15").
Name
growingSeasonDays
Type
integer
Description
Number of frost-free days between the last spring frost and first fall frost.

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
  }
}

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"
  }
}