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

# Returns Historical Agweather - Given a lat/lon.

`GET /history/agweather`

Returns Historical Agweather Observations - 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
- `start_date` string, string, required
- `end_date` string, string, required
- `tp` 'daily' | 'hourly', string
- `units` 'S' | 'I' | 'M', string
- `key` string, string, required

## Response `200`

An AGWeather Historical Data Object.

- HistoryAG
  - `lat` number — Latitude
  - `lon` number — Longitude
  - `data` HistoryAGObj[]
    - `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 — Reference evapotranspiration - ET0 (default mm)
    - `precip` number — Accumulated liquid equivalent precipitation (default mm)
    - `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 Temperature (Soil surface Temperature) (Default Celsius)
    - `skin_temp_max` number — Maximum Skin Temperature (Soil surface Temperature) (Default Celsius)
    - `skin_temp_min` number — Minimum Skin Temperature (Soil 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)
    - `timestamp_local` string — Timestamp in local time
    - `timestamp_utc` string — Timestamp UTC
    - `temp_2m_avg` number — Average Temperature at 2 meters (default C)
    - `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

## 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.dev/weatherbit/apis/weatherbit-interactive-swagger-ui-documentation/revisions/31cff6bde48b?raw)