---
title: "Returns Historical Observations - Given a lat/lon."
method: GET
path: "/history/subhourly"
tags: ["Sub-Hourly Historical Weather Data"]
---

# Returns Historical Observations - Given a lat/lon.

`GET /history/subhourly`

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

## Query parameters

- `lat` number, double
- `lon` number, double
- `city` string, string
- `postal_code` string, string
- `country` string, string
- `station` string, string
- `start_date` string, string, required
- `end_date` string, string, required
- `units` 'S' | 'I' | 'M', string
- `lang` 'ar' | 'az' | 'be' | 'bg' | 'bs' | 'ca' | 'cs' | 'de' | 'fi' | 'fr' | 'el' | 'es' | 'et' | 'hr' | 'hu' | 'id' | 'it' | 'is' | 'kw' | 'nb' | 'nl' | 'pl' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sr' | 'sv' | 'tr' | 'uk' | 'zh' | 'zh-tw', string
- `tz` 'local' | 'utc', string
- `key` string, string, required

## Response `200`

An Historical Data Object.

- HistorySubhourly
  - `city_name` string — Nearest city name
  - `state_code` string — State abbreviation
  - `country_code` string — Country abbreviation
  - `timezone` string — Local IANA time zone
  - `lat` number — Latitude
  - `lon` number — Longitude
  - `city_id` string — Nearest city ID
  - `sources` string[] — List of data sources used in response
  - `station_id` string — [DEPRECATED] Deprecated - use 'sources'
  - `data` HistorySubhourlyObj[]
    - `ts` number — Unix Timestamp
    - `timestamp_local` string — Timestamp in local time
    - `timestamp_utc` string — Timestamp UTC
    - `revision_status` string — Data revision status (interim or final). interim = Data subject to change.
    - `revision_version` string — Final data revision version.
    - `slp` number — Sea level pressure (mb)
    - `pres` number — Pressure (mb)
    - `rh` integer — Relative Humidity as a percentage (%)
    - `dewpt` number — Dew point (Default Celsius)
    - `temp` number — Temperature (Default Celsius)
    - `app_temp` number — Apparent Temperature - Same as Feels-Like or Heat + Wind Chill Indices (Default Celsius)
    - `wind_spd` number — 10m wind Speed (Default m/s)
    - `wind_gust_spd` number — 10m wind Gust Speed - Default (m/s)
    - `wind_dir` integer — 10m wind direction (Degrees) - Degrees clockwise from 0 = North
    - `uv` number — UV Index (0-11+)
    - `solar_rad` number — Estimated solar radiation (W/m^2) - <a href='https://help.weatherbit.io/what-is-the-solar_rad-field/'>Accounts for cloud cover, and other factors.</a>
    - `ghi` number — Global horizontal solar irradiance (W/m^2)
    - `dhi` number — Diffuse normal solar irradiance (W/m^2)
    - `dni` number — Direct normal solar irradiance (W/m^2)
    - `elev_angle` number — Solar elevation angle (Degrees)
    - `azimuth` number — Solar azimuth angle (Degrees)
    - `vis` number — Visibility (KM)
    - `pod` string — Part of the day (d = day, n = night)
    - `weather` object
      - `icon` string — Icon code for forecast image display
      - `code` integer — Weather Condition code
      - `description` string — Weather Condition description
    - `clouds` integer — Cloud Cover 0-100 (%)
    - `precip_rate` number — Liquid equivalent precipitation rate - Default (mm/hr)
    - `snow_rate` number — Snowfall Rate - Default (mm/hr)

## 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.net/weatherbit/apis/weatherbit-interactive-swagger-ui-documentation.md) · [All operations](https://skmtc.net/weatherbit/apis/weatherbit-interactive-swagger-ui-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/weatherbit/weatherbit-interactive-swagger-ui-documentation/versions/31cff6bde48b/schema)