Climate Projections

Downscaled CMIP6 climate-change projections (daily) from 1950 to 2050.

GET https://api.aisa.one/apis/v1/openmeteo/climate

Climate Projections

cURL

curl --request GET \
  --url https://api.aisa.one/apis/v1/openmeteo/climate \
  --header 'Authorization: Bearer <token>'

200

{
  "latitude": 52.5,
  "longitude": 13.4,
  "generationtime_ms": 3.4,
  "timezone": "GMT",
  "timezone_abbreviation": "GMT",
  "daily_units": {
    "time": "iso8601",
    "temperature_2m_max": "°C",
    "precipitation_sum": "mm"
  },
  "daily": {
    "time": [
      "2050-01-01"
    ],
    "temperature_2m_max": [
      6.9
    ],
    "precipitation_sum": [
      1.2
    ]
  }
}

Retrieve downscaled CMIP6 climate-change projections for a coordinate. start_date, end_date (each yyyy-mm-dd, within 1950-2050) and models are all required — models is a comma-separated list drawn from CMCC_CM2_VHR4, FGOALS_f3_H, HiRAM_SIT_HR, MRI_AGCM3_2_S, EC_Earth3P_HR, MPI_ESM1_2_XR, NICAM16_8S. Request daily variables such as temperature_2m_max, temperature_2m_mean or precipitation_sum; set disable_bias_correction=true for raw model output.

The response returns grid-cell metadata and a daily block with a time array, one array per variable, and a matching daily_units object.

Example: GET /apis/v1/openmeteo/climate?latitude=52.52&longitude=13.41&start_date=2020-01-01&end_date=2050-12-31&models=MRI_AGCM3_2_S,EC_Earth3P_HR&daily=temperature_2m_max,precipitation_sum.

Billing: $0.00015 per call (150 micros USD), metered per request. All Open-Meteo endpoints are GET pass-through — authenticate with your AIsa API key as a bearer token (the same key used across every AIsa /apis/* endpoint); AIsa handles provider access.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

latitude · string · required

WGS84 latitude of the location. Multiple coordinates can be comma-separated.

Example:

"52.52"

longitude · string · required

WGS84 longitude of the location (negative for the Americas). Multiple coordinates can be comma-separated.

Example:

"13.41"

start_date · string<date> · required

Start of the interval, yyyy-mm-dd (ISO 8601).

Example:

"2024-01-01"

end_date · string<date> · required

End of the interval, yyyy-mm-dd (ISO 8601).

Example:

"2024-01-07"

models · string · required

Required. Comma-separated climate models: CMCC_CM2_VHR4, FGOALS_f3_H, HiRAM_SIT_HR, MRI_AGCM3_2_S, EC_Earth3P_HR, MPI_ESM1_2_XR, NICAM16_8S.

Example:

"MRI_AGCM3_2_S,EC_Earth3P_HR"

daily · string

Comma-separated list of daily aggregation variables to return. Requires timezone. Common values: temperature_2m_max, temperature_2m_min, temperature_2m_mean, precipitation_sum, rain_sum, snowfall_sum, wind_speed_10m_mean, wind_speed_10m_max, cloud_cover_mean, relative_humidity_2m_mean, shortwave_radiation_sum, pressure_msl_mean.

Example:

"temperature_2m_max,precipitation_sum"

temperature_unit · enum<string> · default: celsius

Temperature unit. Default celsius.

Available options: celsius, fahrenheit

wind_speed_unit · enum<string> · default: kmh

Wind speed unit. Default kmh.

Available options: kmh, ms, mph, kn

precipitation_unit · enum<string> · default: mm

Precipitation unit. Default mm.

Available options: mm, inch

timeformat · enum<string> · default: iso8601

Time output format. Default iso8601.

Available options: iso8601, unixtime

disable_bias_correction · boolean · default: false

Return raw model output without statistical bias correction. Default false.

cell_selection · enum<string> · default: land

Grid-cell preference for the coordinate. Default land.

Available options: land, sea, nearest

Response

200 - application/json

Climate projection for the interval.

The response is of type object.