Changelog

Notable API changes, new output parameters, and response format updates. For full format details see response formats.

Response format version 3

Live and forecast endpoints for irradiance and weather, rooftop PV power, and advanced PV power are being aligned with the standard response format. Historic radiation and weather also gains finer air_temp precision (it already uses the new date format). New users receive the new version by default; the legacy format retires 1 February 2027.

  • Date format uses explicit UTC offset

    In JSON and CSV, period_end and other timestamps use 2024-07-17T11:30:00+00:00 instead of 2024-07-17T11:30:00.0000000Z. This change applies to these live and forecast endpoints:

    • /data/live/radiation_and_weather
    • /data/forecast/radiation_and_weather
    • /data/live/rooftop_pv_power
    • /data/forecast/rooftop_pv_power
    • /data/live/advanced_pv_power
    • /data/forecast/advanced_pv_power

  • air_temp returned with finer precision

    air_temp has finer precision in version 3 (e.g. 20.1 instead of 20), in both JSON and CSV. This applies only to these radiation and weather endpoints:

    • /data/live/radiation_and_weather
    • /data/forecast/radiation_and_weather
    • /data/historic/radiation_and_weather

  • Brings live and forecast endpoints into line with all other product endpoints

    This update applies the new response format to the remaining live and forecast endpoints for irradiance and weather, rooftop PV power, and advanced PV power. Historic radiation and weather already uses the new date format and is also receiving the finer air_temp precision in this version.

  • New users receive the new version by default

    New accounts receive the new version on the affected endpoints without needing to change the format query string.

  • Legacy version retires on 1 February 2027

    From 1 February 2027, the legacy version will no longer be available and the new version becomes the default response format for all users on the affected endpoints.

  • Existing users can test the new version with format=json;version=3 or format=csv;version=3

    Append ;version=3 to the format query parameter — e.g. format=json;version=3 or format=csv;version=3 — to try the new version on individual requests. format=json and format=csv without a version suffix continue to return the legacy version for existing users until 1 February 2027.

  • Existing users can set the new version as their default in the toolkit

    Sign in to the Solcast toolkit at https://toolkit.solcast.com.au to opt in to the new version as your account default on the affected endpoints, without changing the format query string on every request.

  • Scoped to live, forecast, and historic radiation and weather

    Applies in full (date format and air_temp) to irradiance and weather, rooftop PV power, and advanced PV power live and forecast endpoints. Historic radiation and weather already uses the new date format and receives the air_temp precision change. TMY and other product endpoints already use the aligned format.

Response formats →Solcast toolkit →

PV Power Sites list endpoint response format updated

The GET /resources/pv_power_sites response now includes pagination metadata and returns site records in a results array instead of a top-level array.

  • Read site records from results

    Existing integrations that expected the response itself to be an array should use response.results instead.

  • Pagination support

    Use the skip and take query parameters with the offset and total values in the response.

Before: top-level array

[
  { "resource_id": "cbf6-a872-1cb2-566f", "name": "Example Site" }
]

Now: paginated response

{
  "offset": 0,
  "total": 10,
  "results": [
    { "resource_id": "cbf6-a872-1cb2-566f", "name": "Example Site" }
  ]
}
PV Power Sites endpoint →

Premium PV Power and Premium Wind Power endpoints

New API endpoints provide site-specific deterministic and probabilistic power forecasts for operational PV and wind assets.

  • Premium PV Power forecasts

    Forecast power production for operational PV sites with deterministic and probabilistic outputs.

  • Premium Wind Power forecasts

    Forecast power production for operational wind sites with deterministic and probabilistic outputs.

Premium PV Power endpoint →Premium Wind Power endpoint →

Kimber and HSU soiling model endpoints

New API endpoints provide Kimber and HSU soiling-loss estimates across historic, live, and forecast workflows, returning loss_fraction.

  • Kimber and HSU models

    Use the dedicated endpoints to calculate soiling losses with either the Kimber or HSU model.

  • Historic, live, and forecast workflows

    Soiling-loss estimates are available for historical data, near-real-time actuals, and forecasts up to 14 days ahead.

Soiling endpoints →

New weather_type output parameter

A new output parameter categorises weather conditions into simple, icon-friendly values such as PARTLY CLOUDY, RAIN, and THUNDERSTORM.

  • Request with output_parameters=weather_type

    Include weather_type in your output_parameters list on supported irradiance and weather endpoints.

  • 19 predefined categories

    Values include SUNNY, OVERCAST, FOG, SNOW, DAMAGING WIND, and others documented under weather type values on the output parameters page.

Output parameters →

Unmetered location coordinate precision

Test locations used for evaluation no longer need to match coordinates to six decimal places.

  • Four decimal places required

    Requests using the exact latitude and longitude combinations listed on the unmetered locations page do not count against your transaction quota.

Unmetered locations →

PM2.5 and PM10 parameters

Global particulate matter parameters pm2.5 and pm10 were added to forecast, live, historic, and TMY outputs to support soiling analysis and atmospheric-data workflows.

  • pm2.5 and pm10 output parameters

    Use the new parameters to read airborne particulate matter concentrations for particles smaller than 2.5 and 10 micrometers.

  • Available across data workflows

    The parameters are available in forecast, live, historic, and TMY outputs.

Output parameters →

Air Temp Output Format

The air_temp output parameter for the TMY Radiation and Weather endpoint now returns decimal values instead of integers.

  • Decimal air_temp values

    Update integrations that assumed air_temp was an integer to accept decimal temperature values.

  • TMY Radiation and Weather endpoint

    The format change applies to air_temp values returned by TMY Radiation and Weather requests.

TMY Radiation and Weather endpoint →

Historic API Timestamp Output Format

Historic Radiation and Weather, Rooftop PV Power, and Advanced PV Power endpoints now return timestamps in the yyyy-MM-ddThh:mm:ss±hh:mm format.

  • Timezone-aware timestamps

    Timestamp values include the UTC offset in the format yyyy-MM-ddThh:mm:ss±hh:mm.

  • Historic endpoint coverage

    The format applies to historic Radiation and Weather, Rooftop PV Power, and Advanced PV Power responses.

Historic Radiation and Weather endpoint →Historic Rooftop PV Power endpoint →Historic Advanced PV Power endpoint →