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:

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_idsany ofOptional

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

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

string[]Optional

or

nullOptional

geoany ofOptional

Geographic filter for selecting stations by region. Supports: bounding_box, market_zone, country_key, polygon. Mutually exclusive with station_ids.

or

nullOptional

bounding_boxany ofOptional

[Deprecated] Use geo with type='bounding_box' instead.

Example: {"max_lat":50,"max_lon":10,"min_lat":40,"min_lon":-10}

or

nullOptional

variablesany ofOptional

List of observation variables to return. If not set, returns all.

Example: ["air_temperature_at_height_level_2m","wind_speed_at_height_level_10m"]

or

nullOptional

start_timestring · date-timeRequired

Start time for the query (inclusive)

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

end_timeany ofOptional

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

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

string · date-timeOptional

or

nullOptional

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_zoneany ofOptional

IANA time zone for time formatting. Defaults to UTC.

Example: UTC

stringOptional

or

nullOptional

order_byany ofOptional

Columns to order by. Supports direction suffix: 'time__desc' for descending, 'time__asc' for ascending (default). Can also use object format: {'field': 'time', 'direction': 'desc'}

Example: ["time","station"]

or

nullOptional

paginationany ofOptional

Pagination parameters (limit, offset)

or

nullOptional

Responses

200

Successfully retrieved station data

application/jsonapplication/vnd.apache.arrow.stream

Responseany

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

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_latany ofOptional

Minimum latitude for bounding box filter

number · min: -90 · max: 90Optional

or

nullOptional

max_latany ofOptional

Maximum latitude for bounding box filter

number · min: -90 · max: 90Optional

or

nullOptional

min_lonany ofOptional

Minimum longitude for bounding box filter

number · min: -180 · max: 180Optional

or

nullOptional

max_lonany ofOptional

Maximum longitude for bounding box filter

number · min: -180 · max: 180Optional

or

nullOptional

limitany ofOptional

Maximum number of stations to return

integer · min: 1 · max: 10000Optional

or

nullOptional

Responses

200

Successfully retrieved station list

application/json

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 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

401

Authentication required

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