Forecast data
The forecast service covers 5 days in the past through 10 days into the future. If you don’t specify dates, Leaf returns the next 7 days by default.Forecast models
The default model is
gfs. Leaf selects the best model for any given location when using the default, so you generally don’t need to specify one unless you want data from a particular source.
Forecast variables
Variables available across most models (some models omit soil temperature or soil moisture): Daily: temperature (mean/min/max), soil temperature (mean/min/max), sunrise, sunset, max wind speed, max wind gusts, wind direction, evapotranspiration, rain sum, snowfall sum, precipitation sum. Hourly (additional): dew point, longwave radiation, shortwave radiation, cloud cover, relative humidity, soil moisture at multiple depths.Sunrise and sunset are daily-only. Dew point, radiation, cloud cover, and relative humidity are hourly-only. All other variables appear in both daily and hourly responses.
Historical data
Historical weather data is sourced from ERA5 reanalysis products and goes back to 1940 (ERA5) or 1950 (ERA5-Land). There is a 5-day delay on historical data availability. For weather data within the last 5 days, use the forecast endpoints instead.Historical models
The default is
era5. ERA5-Land offers higher spatial resolution but starts a decade later.
Historical variables
The same variable set as forecast data, with soil moisture measured at different depth intervals: 0–7 cm, 7–28 cm, 28–100 cm, and 100–255 cm (vs. 0–1 cm, 1–3 cm, 3–9 cm, 9–27 cm, 27–81 cm for forecast models).Query options
You can fetch weather data in two ways: By field — Requires a Leaf user ID and field ID. Leaf uses the centroid of the field boundary.Request limits
- Daily endpoints: maximum span of 366 days per request.
- Hourly endpoints: maximum span of 30 days per request.
Units
All numeric values respect theunits parameter:
Response format
All weather endpoints return GeoJSON Features. Thegeometry is a Point (field centroid or the lat/lon you specified). The properties object contains each weather variable as a named key with values (time series array) and unit.
null.
What to do next
- API Reference: Weather — Full endpoint reference with all parameters and response schemas.