Sign in

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.

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.

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
    }
  ]
}
All 6 operations