v1

latestOpenAPI 3.1.0MIT2026-07-1461669.5 KB

Internals

Weather sources (stations)

Return a list of all Bright Sky sources matching the given location criteria, ordered by distance.

You must supply both lat and lon or one of dwd_station_id, wmo_station_id, or source_id.

get/sources

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

Response

Successful Response

Example response

{
  "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
    }
  ]
}