API Overview

Querying Climate Data

There are two ways to query climate data from the Meteonorm API:

/climate/tmy. Typical meteorological years, based on climatological data.
/climate/amy. Actual meteorological years, based on obvervations (ground stations and satellites) and reanalysis data.

TMYs

Here's how you generate a TMY for:

a south-facing (180°) surface with a tilt of 30°,
a temporal resolution (frequency) of 1 minute,
parameters global horizontal and tilted irradiance, PV production, and temperature,
taking into account shading caused by the surrounding terrain/horizon.

Code(sh)
 
PARAMETERS="global_horizontal_irradiance,\
global_horizontal_irradiance_with_shading,\
global_tilted_irradiance,\
global_tilted_irradiance_with_shading,\
pv_production,\
pv_production_with_shading,\
temperature"

curl -H "Authorization: Bearer demo0000-0000-0000-0000-000000000000" \
    --get \
    --data "lat=50" \
    --data "lon=10" \
    --data "surface_azimuth=180" \
    --data "surface_tilt=30" \
    --data "horizon=auto" \
    --data "frequency=1_minute" \
    --data "parameters=$PARAMETERS" \
    "https://demo.meteonorm.com/v1/climate/tmy"

To generate a TMY for, e.g., the year 2060 based on climate change scenario SSP245, use the arguments future_scenario and future_year:

Code(sh)
 
curl -H "Authorization: Bearer demo0000-0000-0000-0000-000000000000" \
    --get \
    --data "lat=50" \
    --data "lon=10" \
    --data "future_scenario=ssp2_45" \
    --data "future_year=2060" \
    --data "parameters=global_horizontal_irradiance,temperature,precipitation" \
    "https://demo.meteonorm.com/v1/climate/tmy"

See the API Reference for a complete list of options.

Note: These examples use our demo API URL. No registration required! See Free lat/lon locations for more information on how you can test the Meteonorm API free of charge. For operational use, replace demo.meteonorm.com with api.meteonorm.com.

AMYs

Because Actual Meteorological Years are based on observations, you have to specify the start month (YYYY-MM) of the desired year. Here's how you query an AMY for the year 2022:

Code(sh)
 
PARAMETERS="global_horizontal_irradiance,\
global_horizontal_irradiance_with_shading,\
global_tilted_irradiance,\
global_tilted_irradiance_with_shading,\
pv_production,\
pv_production_with_shading,\
temperature"

curl -H "Authorization: Bearer demo0000-0000-0000-0000-000000000000" \
    --get \
    --data "start=2022-01" \
    --data "lat=50" \
    --data "lon=10" \
    --data "surface_azimuth=180" \
    --data "surface_tilt=30" \
    --data "horizon=auto" \
    --data "frequency=1_hour" \
    --data "parameters=$PARAMETERS" \
    "https://demo.meteonorm.com/v1/climate/amy"

Last modified on February 22, 2026

List of parameters Querying observations