Reanalysis

Query reanalysis data from models like ARCO ERA5 for historical weather analysis.

Query reanalysis data

post

Query reanalysis data from models like ARCO ERA5.

Reanalysis data provides historical weather analysis at a specific time (unlike forecasts which have init_time + prediction_timedelta dimensions). This is useful for:

• Historical weather analysis

• Training and validating machine learning models

• Comparing forecasts against actuals

Query Dimensions:

• models: Reanalysis model(s) to query (e.g., ["arco_era5"])

• geo: Location filter (point, bounding_box, polygon, market_zone, country_key)

• time: Time(s) to query - "latest", single datetime, list of datetimes, or time range

• variables: Weather variables to retrieve

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

Default: jsonPossible values:

streambooleanOptional

If true, stream the response as an Apache Arrow IPC stream. Overrides 'format' to 'arrow'.

Default: false

request_credit_limitnumberOptional

Maximum credits allowed for this request. Query will fail if estimated cost exceeds this limit

Default: 50

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 object for retrieving reanalysis data.

Reanalysis data uses a simple time dimension (unlike forecasts which have init_time + prediction_timedelta). This provides historical analysis data at specified timestamps.

Example: python query = ReanalysisQuery( models=["arco_era5"], geo={"type": "point", "value": [(52.52, 13.405)]}, time={"start": "2024-01-01T00:00:00Z", "end": "2024-01-07T00:00:00Z"}, variables=["air_temperature_at_height_level_2m"], )

timeany ofRequired

Time(s) to query. Can be 'latest' (or integer offset 0), a single datetime, a list of datetimes, or a TimeSlice range.

Example: latest

integerOptional

Offset from latest forecast (0 = latest, 1 = second latest, etc.)

or

string · date-timeOptional

or

stringOptional

Use 'latest' or 'latest-N' for relative init times

Pattern: ^latest(-\d+)?$

or

or

or

include_timebooleanOptional

Include the time column in results (default: True)

Default: true

time_zonestring · nullableOptional

IANA time zone name for time formatting (e.g., 'Europe/Berlin', 'America/New_York'). Defaults to UTC

Example: UTC

were_variables_explicitly_requestedbooleanOptional

Whether the user passed the variables explicitly. If True, the variables will be used to filter the results. If False, all variables will be returned.

Default: true

Responses

200

Successfully retrieved reanalysis data

application/jsonapplication/vnd.apache.arrow.stream

anyOptional

400

Invalid query parameters

401

Authentication required

402

Insufficient credits

403

Insufficient permissions

422

Validation Error

application/json

post/v1/reanalysis/data

HTTPcURLJavaScriptPython

POST /v1/reanalysis/data HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 244

{
  "models": [
    "arco_era5"
  ],
  "geo": {
    "type": "point",
    "value": [
      [
        52.52,
        13.405
      ]
    ],
    "method": "nearest"
  },
  "time": {
    "start": "2024-01-15T00:00:00Z",
    "end": "2024-01-16T00:00:00Z"
  },
  "variables": [
    "air_temperature_at_height_level_2m",
    "wind_speed_at_height_level_10m"
  ]
}

Query single point for one dayQuery latest available dataMarket zone queryAggregation query

{
  "time": [
    "2024-01-15T00:00:00Z",
    "2024-01-15T01:00:00Z",
    "2024-01-15T02:00:00Z"
  ],
  "latitude": [
    52.5,
    52.5,
    52.5
  ],
  "longitude": [
    13.5,
    13.5,
    13.5
  ],
  "air_temperature_at_height_level_2m": [
    271.5,
    271.2,
    270.8
  ]
}

Get reanalysis dataset metadata

get

Get metadata about available reanalysis models including:

• Model names and display names

• Grid resolution and temporal resolution

• Available variables

Authentication: Requires API key.

Authorizations

HTTPBearer

Responses

200

Successfully retrieved metadata

application/json

Metadata about available reanalysis models.

401

Authentication required

422

Validation Error

application/json

get/v1/reanalysis/meta

HTTPcURLJavaScriptPython

GET /v1/reanalysis/meta HTTP/1.1
Accept: */*

{
  "models": [
    {
      "name": "arco_era5",
      "display_name": "ARCO ERA5",
      "grid_resolution": "0.25° x 0.25°",
      "temporal_resolution_minutes": 60,
      "variables": [
        "air_temperature_at_height_level_2m",
        "..."
      ]
    }
  ]
}

Get latest available timestamp

get

Get the latest available timestamp for each specified reanalysis model.

This is useful for knowing what data is currently available without making a full query.

Authentication: Requires API key.

Authorizations

HTTPBearer

Query parameters

modelsstring[]Optional

List of reanalysis models to check

Default: ["arco_era5"]Example: arco_era5

Responses

200

Successfully retrieved latest timestamps

application/json

Result containing latest timestamps per model.

401

Authentication required

422

Validation Error

application/json

get/v1/reanalysis/latest-timestamp

HTTPcURLJavaScriptPython

GET /v1/reanalysis/latest-timestamp HTTP/1.1
Accept: */*

{
  "timestamps": {
    "arco_era5": "2024-01-15T12:00:00Z"
  }
}

Get available timestamps

get

Get a list of available timestamps for each specified reanalysis model within an optional time range.

Authentication: Requires API key.

Authorizations

HTTPBearer

Query parameters

modelsstring[]Optional

List of reanalysis models to check

Default: ["arco_era5"]Example: arco_era5

sincestring · date-time · nullableOptional

Only return timestamps >= this time (inclusive)

beforestring · date-time · nullableOptional

Only return timestamps < this time (exclusive)

limitinteger · min: 1 · max: 1000Optional

Maximum number of timestamps to return

Default: 100

Responses

200

Successfully retrieved available timestamps

application/json

Result containing available timestamps per model.

401

Authentication required

422

Validation Error

application/json

get/v1/reanalysis/available-timestamps

HTTPcURLJavaScriptPython

GET /v1/reanalysis/available-timestamps HTTP/1.1
Accept: */*

{
  "timestamps": {
    "arco_era5": [
      "2024-01-15T00:00:00Z",
      "2024-01-15T01:00:00Z",
      "2024-01-15T02:00:00Z"
    ]
  }
}