Variables, Units & Resolution
Reference for variables, units, granularity, statistics, and spatial resolution available on each endpoint. Includes downscaling rules and current-vs-legacy differences.
This page is the source of truth for what each endpoint can return. We lead with the current endpoints since those are the recommended path; the legacy matrices follow for reference.
Variables
The slug is the value to pass in the var query parameter.
|
Variable |
Slug |
Units |
|---|---|---|
|
Mean Temperature |
|
°C |
|
Max Temperature |
|
°C |
|
Min Temperature |
|
°C |
|
Precipitation |
|
mm |
|
Soil Temperature |
|
°C |
|
Relative Humidity |
|
% |
|
Evapotranspiration |
|
mm |
|
Solar Radiation |
|
W/m² |
|
Soil Moisture |
|
% |
|
Mean Wind Speed |
|
km/h |
|
Max Wind Speed |
|
km/h |
|
Max Wind Gust |
|
km/h |
Not every variable is available on every endpoint — see the Current endpoint availability and Legacy endpoint availability matrices below.
Spatial resolution and downscaling
The API supports two spatial resolutions: a default ~25 km (0.25° grid) and a downscaled ~1 km (0.0083°) for select variables (Mean/Max/Min Temperature and Solar Radiation, marked in the matrix below). Access to 1 km downscaling is enabled at the account level — contact your ClimateAI account manager to enable it on an existing API key. Once enabled, the current endpoints expose a per-request use_downscaling flag to toggle it on or off per call.
Once enabled, downscaling applies only to the four downscalable variables; for all other variables the response is at the native 0.25° grid regardless. On the current endpoints, the per-request use_downscaling=true flag (default) requests the downscaled resolution; if the account isn't provisioned for 1 km, the flag has no effect and the response stays at 0.25°.
Current endpoint availability
Climatology is not yet here. The tables below cover Forecasts (/v2/forecast*) and History (/v2/history). Climatology is still served only by the legacy /v1/climatology endpoint; a flexible replacement is coming soon.
Variable availability
|
Variable |
Slug |
Units |
|
|
Downscalable to 0.0083° |
|---|---|---|---|---|---|
|
Mean Temperature |
|
°C |
✓ |
✓ |
✓ |
|
Max Temperature |
|
°C |
✓ |
✓ |
✓ |
|
Min Temperature |
|
°C |
✓ |
✓ |
✓ |
|
Precipitation |
|
mm |
✓ |
✓ |
|
|
Soil Temperature |
|
°C |
✓ |
✓ |
|
|
Relative Humidity |
|
% |
✓ |
✓ |
|
|
Evapotranspiration |
|
mm |
✓ |
✓ |
|
|
Solar Radiation |
|
W/m² |
✓ |
✓ |
✓ |
|
Soil Moisture |
|
% |
✓ |
✓ |
|
|
Mean Wind Speed |
|
km/h |
✓ |
✓ |
|
|
Max Wind Speed |
|
km/h |
✓ |
✓ |
|
|
Max Wind Gust |
|
km/h |
✓ |
✓ |
Granularity
Both /v2/forecast* and /v2/history accept daily (default), weekly (ISO weeks Mon–Sun, only complete weeks), or monthly (only complete months). Variable-aware aggregation: precipitation/evaporation are summed; temperature/humidity/wind are averaged.
Statistics
|
Endpoint |
What's returned |
|---|---|
|
|
Per-ensemble-member values |
|
|
Mean and custom quantiles (any value in |
|
|
Aggregated values (no quantiles, no terciles) |
Legacy endpoint availability
Variable availability
|
Variable |
Slug |
Units |
History |
Climatology |
Short-term |
Subseasonal |
Seasonal |
Downscalable to 0.0083° |
|---|---|---|---|---|---|---|---|---|
|
Mean Temperature |
|
°C |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Max Temperature |
|
°C |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Min Temperature |
|
°C |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Precipitation |
|
mm |
✓ |
✓ |
✓ |
✓ |
✓ |
|
|
Soil Temperature |
|
°C |
✓ |
✓ |
✓ |
✓ |
✓ |
|
|
Relative Humidity |
|
% |
✓ |
✓ |
✓ |
✓ |
✓ |
|
|
Evapotranspiration |
|
mm |
✓ |
✓ |
✓ |
✓ |
✓ |
|
|
Solar Radiation |
|
W/m² |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Soil Moisture |
|
% |
✓ |
✓ |
✓ |
✓ |
✖ |
|
|
Mean Wind Speed |
|
km/h |
✓ |
✓ |
✓ |
✓ |
✓ |
|
|
Max Wind Speed |
|
km/h |
✓ |
✓ |
✓ |
✖ |
✖ |
|
|
Max Wind Gust |
|
km/h |
✓ |
✓ |
first 10 days only |
✖ |
✖ |
Granularity availability
|
Dataset |
Daily |
Weekly |
Monthly |
Notes |
|---|---|---|---|---|
|
History |
✓ |
— |
— |
|
|
Climatology |
✓ |
✓ |
✓ |
|
|
Short-term Forecast |
✓ |
— |
— |
|
|
Subseasonal Forecast |
✓ |
✓ |
— |
Weekly responses include probabilistic terciles in addition to quantiles. |
|
Seasonal Forecast |
✓ |
— |
✓ |
Monthly responses include probabilistic terciles in addition to quantiles. |
Statistics by dataset
History returns raw daily values, not statistical aggregates, and is excluded from this table. The remaining legacy datasets return:
|
Dataset |
Mean |
Quantiles |
Probabilistic terciles |
|---|---|---|---|
|
Climatology |
— |
✓ |
— |
|
Short-term Forecast |
✓ |
✓ |
— |
|
Subseasonal Forecast (daily) |
✓ |
✓ |
— |
|
Subseasonal Forecast (weekly) |
✓ |
✓ |
✓ |
|
Seasonal Forecast (daily) |
✓ |
✓ |
— |
|
Seasonal Forecast (monthly) |
✓ |
✓ |
✓ |

