---
title: "Returns Energy Forecast API response  - Given a single lat/lon."
method: GET
path: "/forecast/energy"
tags: ["Forecast Degree Day API"]
---

# Returns Energy Forecast API response  - Given a single lat/lon.

`GET /forecast/energy`

Retrieve an 8 day forecast relevant to te Energy Sector (degree days, solar radiation, precipitation, wind).

## Query parameters

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

## Response `200`

An Energy Data Object.

- EnergyObsGroupForecast
  - `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
  - `threshold_units` string — Degree day threshold units
  - `threshold_value` string — Degree day threshold
  - `data` EnergyForecastSeries[]
    - `date` string — Date
    - `timestamp_local` string, nullable — Timestamp in local time
    - `timestamp_utc` string, nullable — Timestamp UTC
    - `cdd` number — Cooling degree days
    - `hdd` number — Heating degree days
    - `rh` integer — Average Relative humidity (%)
    - `dewpt` number — Average dew point temperature - Default (C)
    - `max_wind_dir` integer — Average max 10m wind direction (Degrees) - Degrees clockwise from 0 = North
    - `max_wind_dir_100m` integer — Average max wind direction at 100m height (Degrees) - Degrees clockwise from 0 = North
    - `max_wind_spd` number — Max 10m wind speed - Default (m/s)
    - `max_wind_spd_100m` number — Max wind speed at 100m height - Default (m/s)
    - `wind_dir` integer — Average wind direction (Degrees) - Degrees clockwise from 0 = North
    - `wind_dir_100m` integer — Average wind direction at 100m height (Degrees) - Degrees clockwise from 0 = North
    - `wind_spd` number — Average wind speed at 10m height - Default (m/s)
    - `wind_spd_100m` number — Average wind speed at 100m height - Default (m/s)
    - `temp` number — Average temperature - Default (C)
    - `temp_wetbulb` number — Average wetbulb temperature - Default (C)
    - `clouds` integer — Average cloud cover (%)
    - `t_ghi` number — Total clear sky global horizontal solar irradiance (W/m^2)
    - `t_dhi` number — Total clear sky diffuse horizontal solar irradiance (W/m^2)
    - `t_dni` number — Total clear sky direct normal solar irradiance (W/m^2)
    - `t_solar_rad` number — Total 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>
    - `sun_hours` number — Average number of daily sun hours - # hours where Solar GHI > 1000 W/m^2
    - `precip` number — Total precipitation in period - Default (mm)
    - `snow` number — Total snowfall in period - Default (mm)

## 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)