---
title: "Returns Agweather Forecast - Given a lat/lon."
method: GET
path: "/forecast/agweather"
tags: ["AgWeather Forecast"]
---

# Returns Agweather Forecast - Given a lat/lon.

`GET /forecast/agweather`

Returns Agweather Forecast  - Given a lat, and lon. See https://www.weatherbit.io/api for API specific rate limits.

## Query parameters

- `lat` number, double, required
- `lon` number, double, required
- `units` 'S' | 'I' | 'M', string
- `key` string, string, required

## Response `200`

An AGWeather Forecast Data Object.

- ForecastAG
  - `lat` number — Latitude
  - `lon` number — Longitude
  - `data` ForecastAGObj[]
    - `bulk_soil_density` number — Bulk Soil Density
    - `dlwrf_avg` number — Average Downward Longwave Radiation Flux (W/m^2)
    - `dlwrf_max` number — Maximum Downward Longwave Radiation Flux (W/m^2)
    - `dlwrf_net` number — Net Downward Longwave Radiation Flux (W/m^2)
    - `dswrf_avg` number — Average Downward Shortwave Radiation Flux (W/m^2)
    - `dswrf_max` number — Maximum Downward Shortwave Radiation Flux (W/m^2)
    - `dswrf_net` number — Net Downward Shortwave Radiation Flux (W/m^2)
    - `evapotranspiration` number — Evapotranspiration (default mm)
    - `precip` number — Accumulated liquid equivalent precipitation (default mm)
    - `pop` number — Probability of Precipitation (%)
    - `pres_avg` number — Average Pressure (default mb)
    - `revision_status` string — Data revision status (interim or final). interim = Data subject to change.
    - `revision_version` string — Final data revision version.
    - `skin_temp_avg` number — Average Skin (Surface) Temperature (default Celsius)
    - `skin_temp_max` number — Maximum Skin (Surface) Temperature (default Celsius)
    - `skin_temp_min` number — Minimum Skin (Surface) Temperature (default Celsius)
    - `soilm_0_10cm` number — Soil Moisture (0-10cm depth) (default mm)
    - `soilm_100_200cm` number — Soil Moisture (100-200cm depth) (default mm)
    - `soilm_10_40cm` number — Soil Moisture (10-40cm depth) (default mm)
    - `soilm_40_100cm` number — Soil Moisture (40-100cm depth) (default mm)
    - `soilt_0_10cm` number — Soil Temperature (0-10cm depth) (default Celsius)
    - `soilt_100_200cm` number — Soil Temperature (100-200cm depth) (default Celsius)
    - `soilt_10_40cm` number — Soil Temperature (10-40cm depth) (default Celsius)
    - `soilt_40_100cm` number — Soil Temperature (40-100cm depth) (default Celsius)
    - `specific_humidity` number — Specific Humidity (kg/kg)
    - `temp_2m_avg` number — Average Temperature at 2 meters (default Celsius)
    - `v_soilm_0_10cm` number — Volumetric Soil Moisture (0-10cm depth) (fraction)
    - `v_soilm_100_200cm` number — Volumetric Soil Moisture (100-200cm depth) (fraction)
    - `v_soilm_10_40cm` number — Volumetric Soil Moisture (10-40cm depth) (fraction)
    - `v_soilm_40_100cm` number — Volumetric Soil Moisture (40-100cm depth) (fraction)
    - `valid_date` string — Valid Date
    - `wind_10m_spd_avg` number — Average Wind Speed at 10 meters (default m/s)

## Other responses

- `204` — No Data Found
- `400` — Client Error
- `403` — Unauthorized/No Access for current plan level
- `429` — Daily or Velocity limit exceeded
- `500` — Internal Server Error

---

[API](https://skmtc.dev/weatherbit/apis/weatherbit-interactive-swagger-ui-documentation.md) · [All operations](https://skmtc.dev/weatherbit/apis/weatherbit-interactive-swagger-ui-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/weatherbit/weatherbit-interactive-swagger-ui-documentation/revisions/31cff6bde48b/schema)