Product
namestring · enum · requiredName of the product.
Enum values:mn-api-poolmn-api-climate-tmy-unlimitedmn-api-climate-amy-unlimitedmn-api-climate-custom-unlimitedmn-api-forecast-basic-unlimitedmn-api-forecast-precision-unlimitedmn-api-observation-realtime-unlimitedmn-api-observation-training-unlimitedExample: mn-api-token-subscr-lvalid_untilstring · date · requiredEnd date of the product validity period.
Example: 2027-01-15T12:00Z
balanceinteger | nullCurrent tokens/AMY calculations remaining.
Example: 900900refill_datestring | null · dateDate when the monthly quota is refilled. Null for non-subscription products.
Example: 2027-01-01T00:00Z
AltitudeOption
^(auto|-?[0-9]+(\.[0…Altitude in meters above sea level.
• auto: Automatic • number: altitude in meters
SurfaceAzimuth
• 0° = oriented towards the north
• 90° = oriented towards the east
• 180° = oriented towards the south
• 270° = oriented towards the west
TrackingMode
• none: No axis tracking. Fixed surface orientation (uses surface_azimuth and surface_tilt parameters).
• 1_axis: Single-axis tracking.
In this mode, parameters surface_azimuth and surface_tilt are ignored.
The solar panels are mounted on a rotational axis parallel to the ground along a North-South line,
tilting dynamically East-to-West to follow the sun's trajectory throughout the day.
Backtracking is applied: the tracking angle does not follow the sun in a naïve way.
Instead, for low sun angles, it moves backwards to its ideal position to prevent row-to-row shading in PV arrays.
The maximum tilt angle is 45° and a ground coverage ratio (GCR) of 0.3 is assumed.
Horizon
^(auto|flat|[0-9]+(,…• flat: Flat horizon (all values are 0°).
• auto: Horizon is determined automatically using a global 30m digital elevation model.
• [comma-separated values]: provide 360 integer values representing elevation angles
(in degrees) of the horizon in 360 directions.
Elevation angles must be ≥0° and <90°.
List indices 0–359 correspond to azimuth:
Index 0 = 0° (North)
Index 90 = 90° (East)
Index 180 = 180° (South)
Index 270 = 270° (West)
Each value indicates the elevation angle at the corresponding azimuth.
Situation
• open: Open site, open terrain, north facing incline, no raised skyline. Applies to most sites.
• depression: Depression or very flat valley floor, in which cold air collects. In Switzerland, for example, particularly in
the Jura and the Alps.
• cold_air_lake: Extensively cold hollows (above 1000 m).
• sea_lake: Shore of sea or larger lake (up to 1 km from the shore).
• city: Centre of a larger city (over 100’000 inhabitants).
• slope_south: South facing incline (more than approx. 10° inclination, facing between SE–S–SW). At least 200 m above valley floor.
• slope_west_east: West or east facing incline (more than approx. 10° inclination, facing between SW–W–NW or NE–E–SE). At least 200 m above valley floor.
• valley: Valley floor in mountainous valley at higher altitudes. Valley floor inclined (flat valleys are often treated as depressions).
• valley_foehn: Valley floor of Föhn valley (regions with warm descending air currents).
• valley_central_alps: Floor of large central Alpine valley (e.g. Alpine regions of Valais, Switzerland).
• valley_alpine_foothills: Valley floor in northern Alpine foothills.
• valley_slope_south: South facing incline (more than approx. 10° inclination, facing between SE–S–SW) up to 200 m above valley.
• valley_slope_west_east: West or east facing incline (more than approx. 10° inclination, facing between SW–W–NW or NE–E–SE) up to 200 m above valley floor.
• summit: Open summit above 500 m. Overlooking surroundings in all directions.
Turbidity
^(auto|[0-9]*\.?[0-9…• auto: turbidity is taken from the Meteonorm database.
• [comma-separated values]: 12 floating point values representing monthly atmospheric turbidity.
MonthlyImportData
global_horizontal_irradiancenumber[] · minItems: 12 · maxItems: 12 · requiredMonthly mean global horizontal irradiance, in W/m². 12 values, one per month, describing a full 12-month period.
Example: [42,75,133,188,233,258,254,221,167,108,54,38]
temperaturenumber[] · minItems: 12 · maxItems: 12Monthly mean air temperature, in °C. 12 values, one per month, describing a full 12-month period.
Example: [-1,0,4,8,13,16,18,17,13,8,3,0]
ClimateImportMode
Selects how the imported monthly values are interpreted.
• typical: The user-provided monthly values describe a typical meteorological year (TMY). They are interpreted as January to December and the output covers a January-to-December year. The start field is ignored.
• actual: The user-provided monthly values describe an actual meteorological year (AMY). The start field is required (the request fails without it) and the 12 values are interpreted as the 12 months beginning at that month.
ClimateImportStartTime
^[0-9]{4}-[0-9]{2}$Start month of the imported values.
A year-month string in the format YYYY-MM.
Required when the mode is "actual". Ignored when the mode is "typical", where the values always cover a January-to-December year.
Examples:
2020-01
2023-12
ClimateImportMonthlyRequest
latnumber · double · min: -90 · max: 90 · requiredExample: 47.3768lonnumber · double · min: -180 · max: 180 · requiredExample: 8.5417modestring · enum · requiredSelects how the imported monthly values are interpreted.
•typical: The user-provided monthly values describe a typical meteorological year (TMY). They are interpreted as January to December and the output covers a January-to-December year. Thestartfield is ignored.
•actual: The user-provided monthly values describe an actual meteorological year (AMY). Thestartfield is required (the request fails without it) and the 12 values are interpreted as the 12 months beginning at that month.Enum values:typicalactualvaluesobject · requiredUser-supplied monthly mean values. Global horizontal irradiance is required; temperature is optional and falls back to the Meteonorm database when omitted.
altitudestring · pattern:^(auto|-?[0-9]+(\.[0…Altitude in meters above sea level. •
auto: Automatic •number: altitude in metersExample: 549Default: autosurface_azimuthnumber · double · max: 360• 0° = oriented towards the north
• 90° = oriented towards the east
• 180° = oriented towards the south
• 270° = oriented towards the westExample: 186Default: 0surface_tiltnumber · double · max: 90• 0° = horizontal
• 90° = verticalDefault: 0tracking_modestring · enum•
none: No axis tracking. Fixed surface orientation (uses surface_azimuth and surface_tilt parameters).
•1_axis: Single-axis tracking. In this mode, parameterssurface_azimuthandsurface_tiltare ignored. The solar panels are mounted on a rotational axis parallel to the ground along a North-South line, tilting dynamically East-to-West to follow the sun's trajectory throughout the day. Backtracking is applied: the tracking angle does not follow the sun in a naïve way. Instead, for low sun angles, it moves backwards to its ideal position to prevent row-to-row shading in PV arrays. The maximum tilt angle is 45° and a ground coverage ratio (GCR) of 0.3 is assumed.Enum values:none1_axisDefault: nonesituationstring · enum•
open: Open site, open terrain, north facing incline, no raised skyline. Applies to most sites.
•depression: Depression or very flat valley floor, in which cold air collects. In Switzerland, for example, particularly in the Jura and the Alps.
•cold_air_lake: Extensively cold hollows (above 1000 m).
•sea_lake: Shore of sea or larger lake (up to 1 km from the shore).
•city: Centre of a larger city (over 100’000 inhabitants).
•slope_south: South facing incline (more than approx. 10° inclination, facing between SE–S–SW). At least 200 m above valley floor.
•slope_west_east: West or east facing incline (more than approx. 10° inclination, facing between SW–W–NW or NE–E–SE). At least 200 m above valley floor.
•valley: Valley floor in mountainous valley at higher altitudes. Valley floor inclined (flat valleys are often treated as depressions).
•valley_foehn: Valley floor of Föhn valley (regions with warm descending air currents).
•valley_central_alps: Floor of large central Alpine valley (e.g. Alpine regions of Valais, Switzerland).
•valley_alpine_foothills: Valley floor in northern Alpine foothills.
•valley_slope_south: South facing incline (more than approx. 10° inclination, facing between SE–S–SW) up to 200 m above valley.
•valley_slope_west_east: West or east facing incline (more than approx. 10° inclination, facing between SW–W–NW or NE–E–SE) up to 200 m above valley floor.
•summit: Open summit above 500 m. Overlooking surroundings in all directions.Enum values:opendepressioncold_air_lakesea_lakecityslope_southslope_west_eastvalleyDefault: openhorizonstring · pattern:^(auto|flat|[0-9]+(,…•
flat: Flat horizon (all values are 0°).
•auto: Horizon is determined automatically using a global 30m digital elevation model.
•[comma-separated values]: provide 360 integer values representing elevation angles (in degrees) of the horizon in 360 directions. Elevation angles must be ≥0° and <90°. List indices 0–359 correspond to azimuth:
Index 0 = 0° (North)
Index 90 = 90° (East)
Index 180 = 180° (South)
Index 270 = 270° (West)
Each value indicates the elevation angle at the corresponding azimuth.Example: 0,0,0,2,4,4,6,10,...,9,7,8,6,5,3,0Default: flatparametersstringExample: global_horizontal_irradiance,global_tilted_irradiance,temperatureDefault: global_horizontal_irradiance,diffuse_horizontal_irradiance,direct_normal_irradiance,temperaturefixed_albedonumber | null · double · min: 0.05 · max: 0.9Local albedo
turbiditystring · pattern:^(auto|[0-9]*\.?[0-9…•
auto: turbidity is taken from the Meteonorm database.
•[comma-separated values]: 12 floating point values representing monthly atmospheric turbidity.Example: 5.2,4,3,3.1,3.0,2.8,3.14,3.0,3,3,4,5Default: autofrequencystring · enumEnum values:1_minute15_minutes1_hour1_day1_monthDefault: 1_hourresponse_formatstring · enumEnum values:csvjsonepwpvsysttmy3pvsolpolysuntrjDefault: jsonradiation_minute_modelstring · enumEnum values:remundDefault: remunddiffuse_radiation_modelstring · enumEnum values:perezDefault: pereztilt_radiation_modelstring · enumEnum values:perezDefault: perezrandom_seedinteger · max: 1000Default: 0clear_sky_radiation_modelstring · enumEnum values:esrasolisDefault: esrastartstring · pattern:^[0-9]{4}-[0-9]{2}$Start month of the imported values.
A year-month string in the format YYYY-MM.
Required when the mode is "actual". Ignored when the mode is "typical", where the values always cover a January-to-December year.
Examples:
2020-01
2023-12Example: 2020-01
FutureScenario
• none: climate reference period is 2001–2020.
• ssp1_26: Shared Socioeconomic Pathway (as defined by the IPCC) SSP1-2.6.
• ssp2_45: Shared Socioeconomic Pathway (as defined by the IPCC) SSP2-4.5.
• ssp3_70: Shared Socioeconomic Pathway (as defined by the IPCC) SSP3-7.0.
ExtremeSetting
ClimateParameters
ForecastParameters
ObservationParameters
ValuesClimate
global_horizontal_irradiancearray | null · requiredglobal_horizontal_irradiance_with_shadingarray | null · requireddirect_horizontal_irradiancearray | null · requireddirect_horizontal_irradiance_with_shadingarray | null · requireddiffuse_horizontal_irradiancearray | null · requireddiffuse_horizontal_irradiance_with_shadingarray | null · requireddirect_normal_irradiancearray | null · requireddirect_normal_irradiance_with_shadingarray | null · requiredglobal_tilted_irradiancearray | null · requiredglobal_tilted_irradiance_with_shadingarray | null · requireddirect_tilted_irradiancearray | null · requireddirect_tilted_irradiance_with_shadingarray | null · requireddiffuse_tilted_irradiancearray | null · requireddiffuse_tilted_irradiance_with_shadingarray | null · requiredpv_productionarray | null · requiredpv_production_with_shadingarray | null · requiredglobal_clear_sky_irradiancearray | null · requireddirect_horizontal_clear_sky_irradiancearray | null · requireddiffuse_clear_sky_irradiancearray | null · requireddirect_normal_clear_sky_irradiancearray | null · requiredprecipitationarray | null · requiredtemperaturearray | null · requireddew_point_temperaturearray | null · requiredsnow_deptharray | null · requiredglobal_extraterrestrial_irradiancearray | null · requiredglobal_extraterrestrial_normal_irradiancearray | null · requireddownwelling_longwave_irradiancearray | null · requiredupwelling_longwave_irradiancearray | null · requiredvertical_longwave_irradiancearray | null · requiredphoto_active_irradiancearray | null · requiredradiation_balancearray | null · requiredglobal_illuminancearray | null · requireddirect_illuminancearray | null · requireddiffuse_illuminancearray | null · requiredlinke_turbidity_factorarray | null · requiredaerosol_optical_deptharray | null · requiredcloud_coverarray | null · requiredalbedoarray | null · requiredsurface_temperaturearray | null · requiredsky_temperaturearray | null · requiredwet_bulb_temperaturearray | null · requiredmixing_ratioarray | null · requiredrelative_humidityarray | null · requiredprecipitable_waterarray | null · requireddriving_rainarray | null · requiredpressurearray | null · requiredwind_speedarray | null · requiredwind_directionarray | null · requiredsolar_elevationarray | null · requiredsolar_azimutharray | null · requiredsurface_azimutharray | null · requiredsurface_tiltarray | null · required
ClimateTMYQualityParameters
start_year_of_irradiance_period_of_nearest_stationinteger · requiredStart year of the irradiance data period at the nearest station.
end_year_of_irradiance_period_of_nearest_stationinteger · requiredEnd year of the irradiance data period at the nearest station.
irradiance_station_data_weightnumber · double · requiredWeight of the station data in the global irradiance estimation.
uncertainty_of_irradiance_estimationnumber · double · requiredUncertainty of the global irradiance estimation.
uncertainty_of_temperature_estimationnumber · double · requiredUncertainty of the temperature estimation.
irradiance_year_to_year_variabilitynumber · double · requiredYear-to-year variability of the global irradiance.
irradiance_yearly_poe10number · double · requiredThe yearly irradiance level associated with a 10% probability of exceedance (PoE10). This value corresponds to the 90th percentile of the irradiance distribution.
irradiance_yearly_poe90number · double · requiredThe yearly irradiance level associated with a 90% probability of exceedance (PoE90). This value corresponds to the 90th percentile of the irradiance distribution.
ClimateTMYResponse
start_timesstring[] · requiredStart or end ISO 8601 date-time strings of each time series interval.
end_timesstring[] · requiredStart or end ISO 8601 date-time strings of each time series interval.
valuesobject · requiredTime series of a climate response.
quality_parametersobject · requiredQuality parameters for the TMY climate data.
metaobject · required
ClimateAMYResponse
start_timesstring[] · requiredStart or end ISO 8601 date-time strings of each time series interval.
end_timesstring[] · requiredStart or end ISO 8601 date-time strings of each time series interval.
valuesobject · requiredTime series of a climate response.
metaobject · required
ClimateImportResponse
start_timesstring[] · requiredStart or end ISO 8601 date-time strings of each time series interval.
end_timesstring[] · requiredStart or end ISO 8601 date-time strings of each time series interval.
valuesobject · requiredTime series of a climate response.
metaobject · required
ValuesForecast
global_horizontal_irradiancearray | null · requiredglobal_horizontal_irradiance_with_shadingarray | null · requireddirect_horizontal_irradiancearray | null · requireddirect_horizontal_irradiance_with_shadingarray | null · requireddiffuse_horizontal_irradiancearray | null · requireddiffuse_horizontal_irradiance_with_shadingarray | null · requireddirect_normal_irradiancearray | null · requireddirect_normal_irradiance_with_shadingarray | null · requiredglobal_tilted_irradiancearray | null · requiredglobal_tilted_irradiance_with_shadingarray | null · requireddirect_tilted_irradiancearray | null · requireddirect_tilted_irradiance_with_shadingarray | null · requireddiffuse_tilted_irradiancearray | null · requireddiffuse_tilted_irradiance_with_shadingarray | null · requiredpv_productionarray | null · requiredpv_production_with_shadingarray | null · requiredglobal_clear_sky_irradiancearray | null · requiredprecipitationarray | null · requiredtemperaturearray | null · requireddew_point_temperaturearray | null · requiredsnow_deptharray | null · requiredcloud_coverarray | null · requiredrelative_humidityarray | null · requiredpressurearray | null · requiredwind_speedarray | null · requiredwind_directionarray | null · requiredwind_gustsarray | null · requiredweather_symbolarray | null · requiredsurface_azimutharray | null · requiredsurface_tiltarray | null · required
ForecastResponse
start_timesstring[] · requiredStart or end ISO 8601 date-time strings of each time series interval.
end_timesstring[] · requiredStart or end ISO 8601 date-time strings of each time series interval.
valuesobject · requiredTime series of a forecast response.
metaobject · required
ValuesObservation
global_horizontal_irradiancearray | null · requiredglobal_horizontal_irradiance_with_shadingarray | null · requireddirect_horizontal_irradiancearray | null · requireddirect_horizontal_irradiance_with_shadingarray | null · requireddiffuse_horizontal_irradiancearray | null · requireddiffuse_horizontal_irradiance_with_shadingarray | null · requireddirect_normal_irradiancearray | null · requireddirect_normal_irradiance_with_shadingarray | null · requiredglobal_tilted_irradiancearray | null · requiredglobal_tilted_irradiance_with_shadingarray | null · requireddirect_tilted_irradiancearray | null · requireddirect_tilted_irradiance_with_shadingarray | null · requireddiffuse_tilted_irradiancearray | null · requireddiffuse_tilted_irradiance_with_shadingarray | null · requiredpv_productionarray | null · requiredpv_production_with_shadingarray | null · requiredglobal_clear_sky_irradiancearray | null · requiredtemperaturearray | null · requiredsnow_deptharray | null · requiredsurface_azimutharray | null · requiredsurface_tiltarray | null · required
ObservationResponse
start_timesstring[] · requiredStart or end ISO 8601 date-time strings of each time series interval.
end_timesstring[] · requiredStart or end ISO 8601 date-time strings of each time series interval.
valuesobject · requiredTime series of an observation response.
metaobject · required
Metadata
versionstring · requiredMeteonorm version used to generate the response
Example: 9.0.0commitstring · requiredCommit hash of the Meteonorm backend used to generate the response
Example: a1b2c3d4frequencystring · enum · requiredEnum values:1_minute15_minutes1_hour1_day1_monthparametersobject[] · requiredlatnumber · double · min: -90 · max: 90 · requiredExample: 47.3768lonnumber · double · min: -180 · max: 180 · requiredExample: 8.5417altitudenumber · double · min: -1000 · max: 10000 · requiredAltitude in meters above sea level.
surface_azimuthnumber · double · max: 360 · required• 0° = oriented towards the north
• 90° = oriented towards the east
• 180° = oriented towards the south
• 270° = oriented towards the westExample: 186Default: 0surface_tiltnumber · double · max: 90 · required• 0° = horizontal
• 90° = verticalDefault: 0
time_zonenumber · enum · doubleUTC offset in hours.
Enum values:-12-11-10-9.5-9-8-7-6
Parameter
descriptionstring · requiredDescription of parameter
Example: Global horizontal irradiancenamestring · requiredunique name of parameter
Example: global_horizontal_irradianceunitobject · requiredaggregation_methodstring · enum · requiredEnum values:averageinstantminmaxsumExample: average
Unit
namestring · requiredstring representation of unit
Example: W/m**2descriptionstring · requireddescription of unit
Example: Watt per square meter
AltitudeResponse
altitudenumber · double · min: -1000 · max: 10000 · requiredAltitude in meters above sea level.
HorizonResponse
azimuthinteger[] · minItems: 360 · maxItems: 360 · requiredAzimuth angles (in degrees) corresponding to horizon elevation angles in "HorizonElevation".
0° = north, 90° = east, 180° = south, 270° = west.elevationinteger[] · minItems: 360 · maxItems: 360 · required360 integer values representing elevation angles (0° to 90°) of the horizon. Array indices correspond to azimuths, e.g. index 0 corresponds to azimuth 0°. Each value indicates the elevation angle at the corresponding azimuth. The given example corresponds to a "20° mountain" in the north and a flat horizon in all other directions.
Example: [20,20,20,19,18,17,...,0,0,0,0,0,0,...,18,19,20,20,20,20]