Sign in

v1

latestOpenAPI 3.1.0MIT2026-07-1461669.5 KB

Hourly weather (including forecasts)

Returns a list of hourly weather records (and/or forecasts) for the time range given by date and last_date.

To set the location for which to retrieve records (and/or forecasts), you must supply both lat and lon or one of dwd_station_id, wmo_station_id, or source_id.

get/weather

Query parameters

datestring date-time required

Timestamp of first weather record (or forecast) to retrieve, in ISO 8601 format. May contain time and/or UTC offset.

Example:2023-08-07

Timestamp of first weather record (or forecast) to retrieve, in ISO 8601 format. May contain time and/or UTC offset.

last_datestring date-time

Timestamp of last weather record (or forecast) to retrieve, in ISO 8601 format. Will default to date + 1 day.

Example:2023-08-08

Timestamp of last weather record (or forecast) to retrieve, in ISO 8601 format. Will default to date + 1 day.

latnumber

Latitude in decimal degrees.

Example:52.52

Latitude in decimal degrees.

lonnumber

Longitude in decimal degrees.

Example:13.4

Longitude in decimal degrees.

max_distinteger

Maximum distance of record location from the location given by lat and lon, in meters. Only has an effect when using lat and lon.

Example:10000

Maximum distance of record location from the location given by lat and lon, in meters. Only has an effect when using lat and lon.

dwd_station_idstring[]

DWD station ID, typically five alphanumeric characters. You can supply multiple station IDs separated by commas, ordered from highest to lowest priority.

DWD station ID, typically five alphanumeric characters. You can supply multiple station IDs separated by commas, ordered from highest to lowest priority.

wmo_station_idstring[]

WMO station ID, typically five alphanumeric characters. You can supply multiple station IDs separated by commas, ordered from highest to lowest priority.

WMO station ID, typically five alphanumeric characters. You can supply multiple station IDs separated by commas, ordered from highest to lowest priority.

source_idinteger[]

Bright Sky source ID, as retrieved from the /sources endpoint. You can supply multiple source IDs separated by commas, ordered from highest to lowest priority.

Bright Sky source ID, as retrieved from the /sources endpoint. You can supply multiple source IDs separated by commas, ordered from highest to lowest priority.

tzstring

Timezone in which record timestamps will be presented, as <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones">tz database name</a>. Will also be used as timezone when parsing date and last_date, unless these have explicit UTC offsets. If omitted but date has an explicit UTC offset, that offset will be used as timezone. Otherwise will default to UTC.

Example:Europe/Berlin

Timezone in which record timestamps will be presented, as <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones">tz database name</a>. Will also be used as timezone when parsing date and last_date, unless these have explicit UTC offsets. If omitted but date has an explicit UTC offset, that offset will be used as timezone. Otherwise will default to UTC.

units'dwd' | 'si'

Physical units in which meteorological parameters will be returned. Set to si to use <a href="https://en.wikipedia.org/wiki/International_System_of_Units">SI units</a> (except for precipitation, which is always measured in millimeters). The default dwd option uses a set of units that is more common in meteorological applications and civil use:

<table> <tr><td></td><td>DWD</td><td>SI</td></tr> <tr><td>Cloud cover</td><td>%</td><td>%</td></tr> <tr><td>Dew point</td><td>°C</td><td>K</td></tr> <tr><td>Precipitation</td><td>mm</td><td><s>kg / m²</s> <strong>mm</strong></td></tr> <tr><td>Precipitation probability</td><td>%</td><td>%</td></tr> <tr><td>Pressure</td><td>hPa</td><td>Pa</td></tr> <tr><td>Relative humidity</td><td>%</td><td>%</td></tr> <tr><td>Solar irradiation</td><td>kWh / m²</td><td>J / m²</td></tr> <tr><td>Sunshine</td><td>min</td><td>s</td></tr> <tr><td>Temperature</td><td>°C</td><td>K</td></tr> <tr><td>Visibility</td><td>m</td><td>m</td></tr> <tr><td>Wind (gust) direction</td><td>°</td><td>°</td></tr> <tr><td>Wind (gust) speed</td><td>km / h</td><td>m / s</td></tr> </table>

Physical units in which meteorological parameters will be returned. Set to si to use <a href="https://en.wikipedia.org/wiki/International_System_of_Units">SI units</a> (except for precipitation, which is always measured in millimeters). The default dwd option uses a set of units that is more common in meteorological applications and civil use:

<table> <tr><td></td><td>DWD</td><td>SI</td></tr> <tr><td>Cloud cover</td><td>%</td><td>%</td></tr> <tr><td>Dew point</td><td>°C</td><td>K</td></tr> <tr><td>Precipitation</td><td>mm</td><td><s>kg / m²</s> <strong>mm</strong></td></tr> <tr><td>Precipitation probability</td><td>%</td><td>%</td></tr> <tr><td>Pressure</td><td>hPa</td><td>Pa</td></tr> <tr><td>Relative humidity</td><td>%</td><td>%</td></tr> <tr><td>Solar irradiation</td><td>kWh / m²</td><td>J / m²</td></tr> <tr><td>Sunshine</td><td>min</td><td>s</td></tr> <tr><td>Temperature</td><td>°C</td><td>K</td></tr> <tr><td>Visibility</td><td>m</td><td>m</td></tr> <tr><td>Wind (gust) direction</td><td>°</td><td>°</td></tr> <tr><td>Wind (gust) speed</td><td>km / h</td><td>m / s</td></tr> </table>

Response

Successful Response

Example response

{
  "weather": [
    {
      "timestamp": "2023-08-07T12:30:00+00:00",
      "source_id": 238685,
      "cloud_cover": 12.1,
      "dew_point": -2.5,
      "pressure_msl": 1015.1,
      "relative_humidity": 40,
      "temperature": 10.6,
      "visibility": 50000,
      "fallback_source_ids": {
        "pressure_msl": 11831,
        "wind_speed_30": 11831
      },
      "precipitation": 1.8,
      "solar": 0.563,
      "sunshine": 58,
      "wind_direction": 70,
      "wind_speed": 12.6,
      "wind_gust_direction": 50,
      "wind_gust_speed": 33.5,
      "precipitation_probability": 46,
      "precipitation_probability_6h": 75
    }
  ],
  "sources": [
    {
      "id": 6007,
      "dwd_station_id": "01766",
      "wmo_station_id": "10315",
      "station_name": "Münster/Osnabrück",
      "first_record": "2010-01-01T00:00+02:00",
      "last_record": "2023-08-07T12:40+02:00",
      "lat": 52.1344,
      "lon": 7.6969,
      "height": 47.8,
      "distance": 16365
    }
  ]
}