v1

latestOpenAPI 3.1.0MIT2026-07-1461669.5 KB

Internals

Raw SYNOP observations

Returns a list of ten-minutely SYNOP observations for the time range given by date and last_date. Note that Bright Sky only stores SYNOP observations from the past 30 hours.

To set the weather station for which to retrieve records, you must supply one of dwd_station_id, wmo_station_id, or source_id. The /synop endpoint does not support lat and lon; use the /sources endpoint if you need to retrieve a SYNOP station ID close to a given location.

SYNOP observations are stored as they were reported, which in particular implies that many parameters are only available at certain timestamps. For example, most stations report sunshine_60 only on the full hour, and sunshine_30 only at 30 minutes past the full hour (i.e. also not on the full hour). Check out the /current_weather endpoint for an opinionated compilation of recent SYNOP records into a single "current weather" record.

get/synop

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.

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,
      "sunshine_10": 8
    }
  ],
  "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
    }
  ]
}