Get Forecast Irradiance

Get irradiance and weather forecasts for the requested location from the present up to 14 days ahead, derived from satellite (clouds and irradiance over non-polar continental areas, nowcast for approx. four hours ahead) and numerical weather models (other data and longer horizons).

get/data/forecast/radiation_and_weather

Query parameters

output_parametersstring[]

The output parameters to include in the response.

hoursinteger nullable

The number of hours to return in the response.

period'PT5M' | 'PT10M' | 'PT15M' | 'PT20M' | 'PT30M' | 'PT60M' nullable

Length of the averaging period in ISO 8601 duration format. Default is PT30M.

tiltnumber float nullable

The angle (degrees) that the PV system is tilted off the horizontal. A tilt of 0 means the system faces directly upwards, and 90 means the system is vertical and facing the horizon. If you don't specify tilt, we use a default tilt angle based on the latitude you specify in your request. Must be between 0 and 90.

azimuthnumber float nullable

The azimuth is defined as the angle (degrees) from true north that the PV system is facing. An azimuth of 0 means the system is facing true north. Positive values are anticlockwise, so azimuth is -90 for an east-facing system and 135 for a southwest-facing system. If you don't specify an azimuth, we use a default value of 0 (north facing) in the southern hemisphere and 180 (south-facing) in the northern hemisphere.

array_type'fixed' | 'horizontal_single_axis' nullable

The type of sun-tracking or geometry configuration of your site's modules.

terrain_shadingboolean

If true, irradiance parameters are modified based on the surrounding terrain from a 90m-horizontal-resolution digital elevation model. The direct component of irradiance is set to zero when the beam from the sun is blocked by the terrain. The diffuse component of irradiance is reduced throughout the day if the sky view at the location is significantly reduced by the surrounding terrain. Global irradiance incorporates both effects.

latitudenumber double nullable required

The latitude of the location you request data for. Must be a decimal number between -90 and 90.

longitudenumber double nullable required

The longitude of the location you request data for. Must be a decimal number between -180 and 180.

format'json' | 'csv' nullable

Response format. Default is HTML if not supplied.

Response

forecastsobject[] nullable

Changes

Changed in 1 of the 5 revisions of this API.146

Aug 26, 2026ec8e5425d984146See the full diff
- ▲
  the query request parameter array_type was restricted to a list of enum values
  request-parameter-became-enum
- ○
  added the new enum value fixed to the query request parameter array_type
  request-parameter-enum-value-added
- ○
  added the new enum value horizontal_single_axis to the query request parameter array_type
  request-parameter-enum-value-added
- ○
  added the enum value air_temp to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value albedo to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value azimuth to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value cape to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value clearsky_dhi to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value clearsky_dni to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value clearsky_ghi to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value clearsky_gti to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value cloud_opacity to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value cloud_opacity10 to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value cloud_opacity90 to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value dewpoint_temp to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value dhi to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value dhi10 to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value dhi90 to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value dni to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value dni10 to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value dni90 to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value ghi to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value ghi10 to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value ghi90 to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value gti to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value gti10 to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value gti90 to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value max_air_temp to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value min_air_temp to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value pm10 to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value pm2.5 to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value precipitable_water to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value precipitation_rate to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value relative_humidity to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value snow_depth to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value snow_soiling_ground to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value snow_soiling_rooftop to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value snow_water_equivalent to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value snowfall_rate to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value surface_pressure to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value weather_type to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value wind_direction_100m to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value wind_direction_10m to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value wind_gust to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value wind_speed_100m to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value wind_speed_10m to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
- ○
  added the enum value zenith to the property items/ of the query request parameter output_parameters
  request-parameter-property-enum-value-added
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history