v1

latestOpenAPI 3.1.0MIT2026-07-1461669.5 KB

Current weather

Returns current weather for a given location.

To set the location for which to retrieve weather, you must supply both lat and lon or one of dwd_station_id, wmo_station_id, or source_id.

This endpoint is different from the other weather endpoints in that it does not directly correspond to any of the data available from the DWD Open Data server. Instead, it is a best-effort solution to reflect current weather conditions by compiling SYNOP observations from the past one and a half hours.

get/current_weather

Query parameters

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.

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.

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.

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

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>

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_10": 0.8,
    "precipitation_30": 1.2,
    "precipitation_60": 1.8,
    "solar_10": 0.081,
    "solar_30": 0.207,
    "solar_60": 0.48,
    "sunshine_30": 28,
    "sunshine_60": 52,
    "wind_direction_10": 70,
    "wind_direction_30": 70,
    "wind_direction_60": 70,
    "wind_speed_10": 12.6,
    "wind_speed_30": 12.6,
    "wind_speed_60": 12.6,
    "wind_gust_direction_10": 50,
    "wind_gust_direction_30": 50,
    "wind_gust_direction_60": 50,
    "wind_gust_speed_10": 33.5,
    "wind_gust_speed_30": 33.5,
    "wind_gust_speed_60": 33.5
  },
  "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
    }
  ]
}