---
title: "Forecast"
method: GET
path: "/better_forecast"
tags: ["Forecast"]
---

# Forecast

`GET /better_forecast`

<hr></hr>

## Query parameters

- `station_id` integer
- `lat` number, float
- `lon` number, float
- `units_temp` 'c' | 'f'
- `units_wind` 'mph' | 'kph' | 'kts' | 'mps' | 'bft' | 'lfm'
- `units_pressure` 'mb' | 'inhg' | 'mmhg' | 'hpa'
- `units_precip` 'mm' | 'cm' | 'in'
- `units_distance` 'km' | 'mi'
- `snap_to_nearest_owned_station` boolean

## Response `200`

Successful operation

- object
  - `latitude` number, float
  - `longitude` number, float
  - `timezone` string
  - `timezone_offset_minutes` number
  - `location_name` string
  - `current_conditions` BetterForecastCurrentConditions
    - `conditions` 'Clear' | 'Sunny' | 'Cloudy' | 'Partly Cloudy' | 'Foggy' | 'Windy' | 'Rain Likely' | 'Rain Possible' | 'Very Light Rain' | 'Light Rain' | 'Moderate Rain' | 'Heavy Rain' | 'Very Heavy Rain' | 'Extreme Rain' | 'Thunderstorms Likely' | 'Thunderstorms Possible' | 'Snow Likely' | 'Snow Possible' | 'Wintry Mix Likely' | 'Wintry Mix Possible'
    - `icon` 'clear-day' | 'clear-night' | 'rainy' | 'possible-rainy-day' | 'possible-rainy-night' | 'snow' | 'possible-snow-day' | 'possible-snow-night' | 'sleet' | 'possible-sleet-day' | 'possible-sleet-night' | 'thunderstorm' | 'possibly-thunderstorm-day' | 'possibly-thunderstorm-night' | 'windy' | 'foggy' | 'cloudy' | 'partly-cloudy-day' | 'partly-cloudy-night'
    - `air_temperature` number
    - `sea_level_pressure` number, float
    - `station_pressure` number, float
    - `pressure_trend` 'steady' | 'falling' | 'rising' — Pressure trend over the last 3 hours
    - `relative_humidity` number
    - `wind_avg` number
    - `wind_direction` number — Wind direction in degrees
    - `wind_direction_cardinal` string
    - `wind_gust` number
    - `solar_radiation` number
    - `uv` number
    - `brightness` number — Only returned in requests made with a station_id.
    - `feels_like` number
    - `dew_point` number
    - `wet_bulb_temperature` number
    - `wet_bulb_globe_temperature` number
    - `air_density` number, float — Only returned in requests made with a station_id.
    - `lighting_strike_count_last_1hr` number — Only returned in requests made with a station_id.
    - `lighting_strike_count_last_3hr` number — Only returned in requests made with a station_id.
    - `lighting_strike_last_distance` number — Only returned in requests made with a station_id.
    - `lighting_strike_last_distance_msg` string — Only returned in requests made with a station_id.
    - `lighting_strike_last_epoch` number — Only returned in requests made with a station_id.
    - `precip_accum_local_day` number, float
    - `precip_accum_local_yesterday` number, float
    - `precip_minutes_local_day` number — Only returned in requests made with a station_id.
    - `precip_minutes_local_yesterday` number — Only returned in requests made with a station_id.
    - `is_precip_local_day_rain_check` boolean — Only returned in requests made with a station_id.
    - `is_precip_local_yesterday_rain_check` boolean — Only returned in requests made with a station_id.
  - `forecast` object
    - `daily` BetterForecastDaily[]
      - `day_start_local` number
      - `day_num` number
      - `month_num` number
      - `conditions` 'Clear' | 'Sunny' | 'Cloudy' | 'Partly Cloudy' | 'Foggy' | 'Windy' | 'Rain Likely' | 'Rain Possible' | 'Very Light Rain' | 'Light Rain' | 'Moderate Rain' | 'Heavy Rain' | 'Very Heavy Rain' | 'Extreme Rain' | 'Thunderstorms Likely' | 'Thunderstorms Possible' | 'Snow Likely' | 'Snow Possible' | 'Wintry Mix Likely' | 'Wintry Mix Possible'
      - `icon` 'clear-day' | 'clear-night' | 'rainy' | 'possible-rainy-day' | 'possible-rainy-night' | 'snow' | 'possible-snow-day' | 'possible-snow-night' | 'sleet' | 'possible-sleet-day' | 'possible-sleet-night' | 'thunderstorm' | 'possibly-thunderstorm-day' | 'possibly-thunderstorm-night' | 'windy' | 'foggy' | 'cloudy' | 'partly-cloudy-day' | 'partly-cloudy-night'
      - `sunrise` number — Epoch (seconds, UTC)
      - `sunset` number — Epoch (seconds, UTC)
      - `air_temp_high` number
      - `air_temp_low` number
      - `precip_probability` number
      - `precip_icon` 'chance-rain' | 'chance-snow' | 'chance-sleet'
      - `precip_type` 'rain' | 'snow' | 'sleet'
    - `hourly` BetterForecastHourly[]
      - `time` number
      - `conditions` 'Clear' | 'Sunny' | 'Cloudy' | 'Partly Cloudy' | 'Foggy' | 'Windy' | 'Rain Likely' | 'Rain Possible' | 'Very Light Rain' | 'Light Rain' | 'Moderate Rain' | 'Heavy Rain' | 'Very Heavy Rain' | 'Extreme Rain' | 'Thunderstorms Likely' | 'Thunderstorms Possible' | 'Snow Likely' | 'Snow Possible' | 'Wintry Mix Likely' | 'Wintry Mix Possible'
      - `icon` 'clear-day' | 'clear-night' | 'rainy' | 'possible-rainy-day' | 'possible-rainy-night' | 'snow' | 'possible-snow-day' | 'possible-snow-night' | 'sleet' | 'possible-sleet-day' | 'possible-sleet-night' | 'thunderstorm' | 'possibly-thunderstorm-day' | 'possibly-thunderstorm-night' | 'windy' | 'foggy' | 'cloudy' | 'partly-cloudy-day' | 'partly-cloudy-night'
      - `air_temperature` number
      - `sea_level_pressure` number, float
      - `relative_humidity` number
      - `precip` number, float
      - `precip_probability` number
      - `precip_type` 'rain' | 'snow' | 'sleet'
      - `precip_icon` 'chance-rain' | 'chance-snow' | 'chance-sleet'
      - `wind_avg` number
      - `wind_direction` number — Wind direction in degrees
      - `wind_direction_cardinal` string
      - `wind_gust` number
      - `wind_gust_color` string
      - `uv` number
      - `feels_like` number
      - `local_hour` number
      - `local_day` number
  - `status` Status
    - `status_code` integer
    - `status_message` string
  - `units` Units
    - `units_temp` 'c' | 'f'
    - `units_wind` string
    - `units_precip` string
    - `units_pressure` string
    - `units_distance` string
    - `units_brightness` string
    - `units_solar_radiation` string
    - `units_other` string
    - `units_air_density` string
  - `source_id` number
  - `source_id_conditions` number
  - `build_code` string
  - `refresh_interval_seconds` number

## Other responses

- `401`

---

[API](https://skmtc.dev/tempestwx/apis/tempestone-api.md) · [All operations](https://skmtc.dev/tempestwx/apis/tempestone-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tempestwx/tempestone-api/revisions/e882b41e740d/schema)