Station Data

Query weather station observation data including temperature, wind, precipitation, and more.

Query station observation data

post

Query weather station observation data including:

• Temperature, dew point, wind speed/direction

• Atmospheric pressure (surface and MSL)

• Precipitation accumulations (1h, 3h, 6h, 12h, 24h)

• Solar radiation and cloud cover

Filtering Options:

• station_ids: List of specific station IDs

• bounding_box: Geographic bounds (min/max lat/lon)

• variables: Subset of observation variables

Temporal Aggregation:

• none: Raw observations (default)

• hourly: Hourly averages

• daily: Daily averages

Response Formats:

• json: Columnar JSON format {column: [values], ...}

• arrow: Apache Arrow IPC stream for efficient processing

Authentication: Requires API key.

For more information, see docs.jua.ai.

Authorizations

HTTPBearer

Query parameters

formatstring · enumOptional

Response format: 'json' for columnar JSON or 'arrow' for Apache Arrow format

Default: jsonPossible values:

include_unitsbooleanOptional

When true, JSON responses are wrapped in {data, units}. Units are always sent via X-Variable-Units header regardless.

Default: false

Body

application/json

Query parameters for station observation data.

Supports filtering by:

• station_ids: List of specific station IDs (mutually exclusive with geo)
• geo: GeoFilter for region-based filtering (bounding_box, market_zone, country_key, polygon)
• variables: List of observation variables to return
• start_time / end_time: Time range for observations
• aggregation: Temporal aggregation (none, hourly, daily)

station_idsstring[] · nullableOptional

List of ICAO station codes to query. Mutually exclusive with geo.

Example: ["EDDT","EDDH","LFPG"]

start_timestring · date-timeRequired

Start time for the query (inclusive)

Example: 2024-01-01T00:00:00Z

end_timestring · date-time · nullableOptional

End time for the query (exclusive). If not set, no upper bound.

Example: 2024-01-07T00:00:00Z

aggregationstring · enumOptional

Temporal aggregation to apply (none, hourly, daily)

Default: nonePossible values:

aggregate_across_stationsbooleanOptional

If True and aggregation is hourly/daily, compute mean across all stations (regional average). If False, compute mean per station.

Default: false

time_zonestring · nullableOptional

IANA time zone for time formatting. Defaults to UTC.

Example: UTC

Responses

200

Successfully retrieved station data

application/jsonapplication/vnd.apache.arrow.stream

anyOptional

400

Invalid query parameters

401

Authentication required

403

Insufficient permissions

422

Validation Error

application/json

post/v1/station-data/data

HTTPcURLJavaScriptPython

POST /v1/station-data/data HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 145

{
  "station_ids": [
    "EDDT"
  ],
  "variables": [
    "air_temperature_at_height_level_2m"
  ],
  "start_time": "2025-08-01T00:00:00Z",
  "end_time": "2025-08-07T00:00:00Z"
}

Query temperature for stationsQuery by geographic regionDaily aggregated data

{
  "time": [
    "2024-01-01T00:00:00Z",
    "2024-01-01T01:00:00Z"
  ],
  "station": [
    "EDDT",
    "EDDT"
  ],
  "name": [
    "BERLIN-TEGEL",
    "BERLIN-TEGEL"
  ],
  "latitude": [
    52.56,
    52.56
  ],
  "longitude": [
    13.28,
    13.28
  ],
  "air_temperature_at_height_level_2m": [
    275.5,
    274.8
  ]
}

Query solar station observation data

post

Query solar radiation station observations (surface_downwelling_shortwave_flux_sum_1h, hourly-accumulated GHI in J/m²).

Solar stations are a distinct, quality-audited network from the synoptic stations and are served from a separate table. Pass namespaced station ids (solar:<station_id>) via station_ids alongside a time range.

Authentication: Requires API key.

Authorizations

HTTPBearer

Query parameters

formatstring · enumOptional

Response format: 'json' for columnar JSON or 'arrow' for Apache Arrow format

Default: jsonPossible values:

include_unitsbooleanOptional

When true, JSON responses are wrapped in {data, units}. Units are always sent via X-Variable-Units header regardless.

Default: false

Body

application/json

Query parameters for station observation data.

Supports filtering by:

• station_ids: List of specific station IDs (mutually exclusive with geo)
• geo: GeoFilter for region-based filtering (bounding_box, market_zone, country_key, polygon)
• variables: List of observation variables to return
• start_time / end_time: Time range for observations
• aggregation: Temporal aggregation (none, hourly, daily)

station_idsstring[] · nullableOptional

List of ICAO station codes to query. Mutually exclusive with geo.

Example: ["EDDT","EDDH","LFPG"]

start_timestring · date-timeRequired

Start time for the query (inclusive)

Example: 2024-01-01T00:00:00Z

end_timestring · date-time · nullableOptional

End time for the query (exclusive). If not set, no upper bound.

Example: 2024-01-07T00:00:00Z

aggregationstring · enumOptional

Temporal aggregation to apply (none, hourly, daily)

Default: nonePossible values:

aggregate_across_stationsbooleanOptional

If True and aggregation is hourly/daily, compute mean across all stations (regional average). If False, compute mean per station.

Default: false

time_zonestring · nullableOptional

IANA time zone for time formatting. Defaults to UTC.

Example: UTC

Responses

200

Successfully retrieved solar station data

application/jsonapplication/vnd.apache.arrow.stream

anyOptional

400

Invalid query parameters

401

Authentication required

422

Validation Error

application/json

post/v1/station-data/solar-data

HTTPcURLJavaScriptPython

POST /v1/station-data/solar-data HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 468

{
  "station_ids": [
    "EDDT",
    "EDDH",
    "LFPG"
  ],
  "geo": {
    "type": "point",
    "value": [
      52.52,
      13.405
    ],
    "method": "nearest"
  },
  "bounding_box": {
    "max_lat": 50,
    "max_lon": 10,
    "min_lat": 40,
    "min_lon": -10
  },
  "variables": [
    "air_temperature_at_height_level_2m",
    "wind_speed_at_height_level_10m"
  ],
  "start_time": "2024-01-01T00:00:00Z",
  "end_time": "2024-01-07T00:00:00Z",
  "aggregation": "none",
  "aggregate_across_stations": false,
  "time_zone": "UTC",
  "order_by": [
    "time",
    "station"
  ],
  "pagination": {
    "limit": 100,
    "offset": 0
  }
}

No content

List available stations

get

Get a list of available weather stations with their metadata.

Optionally filter by geographic bounding box.

Authentication: Requires API key.

Authorizations

HTTPBearer

Query parameters

min_latnumber · min: -90 · max: 90 · nullableOptional

Minimum latitude for bounding box filter

max_latnumber · min: -90 · max: 90 · nullableOptional

Maximum latitude for bounding box filter

min_lonnumber · min: -180 · max: 180 · nullableOptional

Minimum longitude for bounding box filter

max_lonnumber · min: -180 · max: 180 · nullableOptional

Maximum longitude for bounding box filter

limitinteger · min: 1 · max: 10000 · nullableOptional

Maximum number of stations to return

Responses

200

Successfully retrieved station list

application/json

Result containing list of available stations.

total_countintegerRequired

Total number of stations

401

Authentication required

422

Validation Error

application/json

get/v1/station-data/stations

HTTPcURLJavaScriptPython

GET /v1/station-data/stations HTTP/1.1
Accept: */*

{
  "stations": [
    {
      "station": "EDDT",
      "name": "BERLIN-TEGEL",
      "latitude": 52.56,
      "longitude": 13.28,
      "elevation": 3
    }
  ],
  "total_count": 1
}

List available solar-radiation stations

get

Get a list of audited (clean) solar-radiation benchmark stations with their metadata. Solar stations are a distinct, quality-audited network from the synoptic stations and are served from a separate table (solar_station_meta, filtered to is_clean = 1). Ids are namespaced solar:<station_id> to match the solar observation and benchmark read paths.

Optionally filter by geographic bounding box.

Authentication: Requires API key.

Authorizations

HTTPBearer

Query parameters

min_latnumber · min: -90 · max: 90 · nullableOptional

Minimum latitude for bounding box filter

max_latnumber · min: -90 · max: 90 · nullableOptional

Maximum latitude for bounding box filter

min_lonnumber · min: -180 · max: 180 · nullableOptional

Minimum longitude for bounding box filter

max_lonnumber · min: -180 · max: 180 · nullableOptional

Maximum longitude for bounding box filter

limitinteger · min: 1 · max: 10000 · nullableOptional

Maximum number of stations to return

Responses

200

Successfully retrieved solar station list

application/json

Result containing list of available stations.

total_countintegerRequired

Total number of stations

401

Authentication required

422

Validation Error

application/json

get/v1/station-data/solar-stations

HTTPcURLJavaScriptPython

GET /v1/station-data/solar-stations HTTP/1.1
Accept: */*

{
  "stations": [
    {
      "station": "solar:dwd:00867",
      "name": "Berus",
      "latitude": 49.26,
      "longitude": 6.69,
      "elevation": 362
    }
  ],
  "total_count": 1
}

List available variables

get

Get a list of available observation variables with metadata including:

• Variable name

• Description

• Unit of measurement

Authentication: Requires API key.

Authorizations

HTTPBearer

Responses

200

Successfully retrieved variable list

application/json

Result containing list of available variables.

401

Authentication required

422

Validation Error

application/json

get/v1/station-data/variables

HTTPcURLJavaScriptPython

GET /v1/station-data/variables HTTP/1.1
Accept: */*

{
  "variables": [
    {
      "name": "air_temperature_at_height_level_2m",
      "description": "Air temperature at 2 meters above ground",
      "unit": "K"
    },
    {
      "name": "wind_speed_at_height_level_10m",
      "description": "Wind speed at 10 meters above ground",
      "unit": "m/s"
    }
  ]
}