Get Forecast Premium PV
Query Parameters
5 fieldsresource_idrequiredThe resource id of the resource.
hoursThe number of hours to return in the response.
periodLength of the averaging period in ISO 8601 duration format. Default is PT30M.
output_parametersThe output parameters to include in the response. Any p-level variant (1-99, up to one decimal place; no decimal point for whole numbers) of a p-capable base is also accepted if present on your plan (e.g. power_p70, power_p77.5, curtailed_power_p20).
formatResponse format. Default is HTML if not supplied.
Responses
200OK
ForecastPremiumPvPowerResponse▼
OK
forecastsGET/data/forecast/premium_pv_power
curl -X GET "https://api.solcast.com.au/data/forecast/premium_pv_power?resource_id=cbf6-a872-1cb2-566f&output_parameters=power&issue_time=<issue_time>&request_id=<request_id>" \
-H "Authorization: Bearer $API_KEY"{
"forecasts": [
{
"power": 0,
"period_end": "2026-07-30T01:00:00+00:00",
"period": "PT60M"
},
{
"power": 0,
"period_end": "2026-07-30T02:00:00+00:00",
"period": "PT60M"
},
{
"power": 0,
"period_end": "2026-07-30T03:00:00+00:00",
"period": "PT60M"
}
]
}Create Site Measurements
Submit measurement data for a Premium PV Power site. Measurements are used for model training. Maximum 1000 measurements per request. Power units (AC) are measured in MW.
Request Body
2 fieldsresource_idrequiredThe unique identifier of the Premium PV Power resource.
measurementsArray of measurement records (1-1000).
view definition
availabilitycurtailmentperiodperiod_endperiod_startpowerResponses
200OK
CreateSiteMeasurementsResponse▼
OK
resource_idacceptedresponse_statusResponseStatusoptionalview definition
error_codemessagestack_traceerrorsResponseError[]optionalview definition
error_codefield_namemessagemetametaPOST/resources/pv_power_site_measurements
curl -X POST "https://api.solcast.com.au/resources/pv_power_site_measurements" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"measurements": [
{
"availability": 1,
"curtailment": 1,
"period": "string",
"period_end": "2024-07-01T00:00:00.0000000Z",
"period_start": "string",
"power": 1
}
],
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde"
}'{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"accepted": 42,
"response_status": {
"error_code": "string",
"message": "string",
"stack_trace": "string",
"errors": [
{
"error_code": null,
"field_name": null,
"message": null,
"meta": null
}
],
"meta": {}
}
}Retrieve Site Measurements
Retrieve historical measurement data for a Premium PV Power site. Supports pagination via skip/take and date filtering via start/end.
Query Parameters
4 fieldsresource_idrequiredThe unique identifier of the Premium PV Power resource.
startFilter: period_end >= start (ISO-8601).
endFilter: period_end <= end (ISO-8601).
formatResponse format. Default is HTML if not supplied.
Responses
200OK
QueryResponse_PvUtilityMeasurement▼
OK
offsettotalresultsPvUtilityMeasurement[]optionalview definition
idsolar_farm_idperiod_endperiodcreatedtotal_powerinverters_availableavailabilitymean_ghitracking_anglenetwork_constraintconstraint_power_ceilinglocal_limitfrequencymetaresponse_statusResponseStatusoptionalview definition
error_codemessagestack_traceerrorsResponseError[]optionalview definition
error_codefield_namemessagemetametaGET/resources/pv_power_site_measurements
curl -X GET "https://api.solcast.com.au/resources/pv_power_site_measurements?resource_id=cbf6-a872-1cb2-566f&start=2026-01-01&end=<end>" \
-H "Authorization: Bearer $API_KEY"{
"offset": 0,
"total": 0,
"results": []
}List Resources
Lists all PV power sites accessible to the authenticated user. Supports pagination (skip/take), entitlement filtering (advanced/premium), and date range filtering (start/end).
Query Parameters
6 fieldsstartFilter to sites created on or after this date (ISO 8601 format).
endFilter to sites created before this date (ISO 8601 format).
entitlementOptional filter for site entitlement.
show_allWhen true, returns all sites in the system. Requires admin privileges.
querySearch query for site name or resource ID.
forecast_productionFilter to sites where ML forecast production is enabled (premium only).
Responses
200OK
QueryResponse_PvPowerResource▼
OK
offsettotalresultsPvPowerResource[]optionalview definition
resource_idnamelatitudelongitudecapacitycapacity_dcazimuthtilttracking_typeinstall_dategrid_export_limitmodule_typeground_coverage_ratioderating_temp_modulederating_age_systemderating_other_systeminverter_peak_efficiencytracker_axis_azimuthtracker_max_rotation_angletracker_back_trackingtracker_smart_trackingterrain_slopeterrain_azimuthdust_soiling_averagebifacial_systemsite_ground_albedobifaciality_factorpvrow_heightpvrow_widthclearsky_zenith_coefficientsZenithCoefficients[]optionalview definition
Coefficients used to model clear-sky solar zenith irradiance for the resource.
day_of_yearsigned_zenith_coefficientscloudy_zenith_coefficientsZenithCoefficients[]optionalview definition
Coefficients used to model cloudy-sky solar zenith irradiance for the resource.
day_of_yearsigned_zenith_coefficientsmetaresponse_statusResponseStatusoptionalview definition
error_codemessagestack_traceerrorsResponseError[]optionalview definition
error_codefield_namemessagemetametaGET/resources/pv_power_sites
curl -X GET "https://api.solcast.com.au/resources/pv_power_sites?entitlement=<entitlement>&show_all=<show_all>" \
-H "Authorization: Bearer $API_KEY"{
"offset": 0,
"total": 10,
"results": [
{
"resource_id": "cbf6-a872-1cb2-566f",
"name": "GDP - Postman Test Site",
"latitude": 8.2246,
"longitude": -73.323238,
"capacity": 34.88,
"capacity_dc": 40.96,
"azimuth": 152.5,
"tilt": 10.4,
"tracking_type": "fixed",
"install_date": "2023-08-01T07:00:00.0000000Z",
"grid_export_limit": 35,
"module_type": "mono-si",
"ground_coverage_ratio": 0.626,
"derating_temp_module": 0.0034,
"derating_age_system": 0.0045,
"derating_other_system": 0.0525,
"inverter_peak_efficiency": 0.95,
"tracker_axis_azimuth": 0,
"tracker_max_rotation_angle": 60,
"tracker_back_tracking": true,
"tracker_smart_tracking": false,
"terrain_slope": 0,
"terrain_azimuth": 0,
"dust_soiling_average": [
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015
],
"bifacial_system": true,
"site_ground_albedo": 0.25,
"bifaciality_factor": 0.7,
"pvrow_height": 1.5,
"pvrow_width": 2
},
{
"resource_id": "3ae7-2456-492c-9aba",
"name": "Test Site: Fort Peck",
"latitude": 48.30783,
"longitude": -105.1017,
"capacity": 10,
"capacity_dc": 1.27,
"azimuth": 180,
"tilt": 46.59,
"tracking_type": "horizontal_single_axis",
"install_date": "2023-07-01T00:00:00.0000000Z",
"module_type": "poly-si",
"ground_coverage_ratio": 0.47,
"derating_temp_module": 0.0039,
"derating_age_system": 0.0059,
"derating_other_system": 0.07,
"inverter_peak_efficiency": 0.985,
"tracker_axis_azimuth": 0,
"tracker_max_rotation_angle": 60,
"tracker_back_tracking": true,
"tracker_smart_tracking": false,
"terrain_slope": 0,
"terrain_azimuth": 0,
"dust_soiling_average": [
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015
],
"bifacial_system": false,
"site_ground_albedo": 0.25,
"bifaciality_factor": 0.7,
"pvrow_height": 1.5,
"pvrow_width": 2,
"confirmed_metadata": "2024-08-01T08:22:57.5742140Z"
},
{
"resource_id": "8d10-f530-af85-5cbb",
"name": "Test Site: Giza Pyramid Complex",
"latitude": 29.977296,
"longitude": 31.132496,
"capacity": 10,
"capacity_dc": 1.27,
"azimuth": 180,
"tilt": 46.59,
"tracking_type": "horizontal_single_axis",
"install_date": "2023-07-01T00:00:00.0000000Z",
"module_type": "poly-si",
"ground_coverage_ratio": 0.47,
"derating_temp_module": 0.0039,
"derating_age_system": 0.0059,
"derating_other_system": 0.07,
"inverter_peak_efficiency": 0.985,
"tracker_axis_azimuth": 0,
"tracker_max_rotation_angle": 60,
"tracker_back_tracking": true,
"tracker_smart_tracking": false,
"terrain_slope": 0,
"terrain_azimuth": 0,
"dust_soiling_average": [
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015,
0.015
],
"bifacial_system": false,
"site_ground_albedo": 0.25,
"bifaciality_factor": 0.7,
"pvrow_height": 1.5,
"pvrow_width": 2,
"confirmed_metadata": "2024-08-01T08:25:39.5720920Z"
}
]
}Create Resource
Request Body
32 fieldsresource_idrequiredThe unique identifier of the resource.
namerequiredThe name of the resource.
latituderequiredThe latitude of the resource. Must be a decimal number between -90 and 90.
longituderequiredThe longitude of the resource. Must be a decimal number between -180 and 180.
entitlementEntitlement for the site.
capacityTotal inverter (nameplate) capacity in MW. This is the highest potential output of the system before any Site Export Limit is applied. It is used to model the conversion of DC power to AC by your inverters.
capacity_dcTotal module capacity in MW. Usually slightly higher than the AC capacity. It is used to model the generation of DC power by your modules.
azimuthThe angle from true north the modules are facing. North is 0, South is ±180, Eastward facing is negative values. Westward facing is positive values. For example, -90 is due east. It is used to calculate the incident irradiance for your modules.
tiltThe off-horizontal tilt angle of modules for a fixed-tilt site.
tracking_typeThe type of sun-tracking or geometry configuration of your site's modules. It is used to calculate the incident irradiance for your modules.
install_dateThe date when your site was installed. It is used to derate your module (DC) production gradually with age, at a rate dependent on your Module Type.
grid_export_limitThe maximum power export limit in MW that is allowed by the site’s connection with the network operator. It is used to place a final cap on your AC power output. Only impacts your AC power if the grid export limit is set lower than the AC capacity.
module_typeThe type of material or technology used in your site's PV modules. It is used to estimate your module temperature derating coefficient (unless you specify your own coefficient), and used to estimate your module age derating.
ground_coverage_ratioThe proportion of the site's ground area covered by modules. It is used to calculate the incident irradiance for your modules.
derating_temp_moduleThe factor by which your site’s module (DC) production varies with differences in temperature from standard operating conditions ( 25 oC ). Can be found on module spec sheets and its often referred as: temperature coefficient of power or pmp.
derating_age_systemThe factor by which the whole system will be derated per year since Install Date. It is used to calculate time dependent system loss.
derating_other_systemThe total system losses as a fraction of the total energy output. This excludes shading, soiling, snow, inverter, temperature and age. Includes losses such as wiring.
inverter_peak_efficiencyThe peak efficiency value in your inverter efficiency curve. It is used to scale the conversion efficiency of DC to AC, as a function of the inverter load.
tracker_axis_azimuthThe off north-south azimuth angle for a horizontal single axis tracking site. Most commonly this will be close to zero. North is 0, South is ±180, Eastward facing is negative values. Westward facing is positive values. For example, -90 is due east. It is used to calculate the incident irradiance for your modules.
tracker_max_rotation_angleThe maximum off-horizontal angle for a horizontal single axis tracking site. It is used to calculate the incident irradiance for your modules.
tracker_back_trackingWhether the trackers backtrack at low solar elevation angles, for a horizontal single axis tracking site. It is used to calculate the incident irradiance for your modules.
tracker_smart_trackingWhether the trackers move to horizontal during cloudy periods with zero DNI, for a horizontal single axis tracking site. It is used to calculate the incident irradiance for your modules.
terrain_slopeThe average terrain slope in degrees from horizontal of your site. A site with no terrain slope has a value of zero.
terrain_azimuthThe average terrain slope downhill direction. North is 0, South is ±180, Eastward is negative values. Westward is positive values. For example, -90 is due east. It is used to calculate the incident irradiance for your modules.
dust_soiling_averageThe average proportion of module production lost due to dust soiling. The value entered should reflect the impact of cleaning activity at your site. It is used to calculate the module (DC) production.
bifacial_systemBifacial systems have modules that produce solar power not only from the front, but also the rear side of the panel. Used to create additional parameters that will allow us to model your production more accurately.
site_ground_albedoThe proportion of the incident downward irradiance reflected by the ground surface in the area underneath the PV modules. Used to calculate local ground-reflected irradiance. Particularly important for bifacial systems.
bifaciality_factorFor bifacial modules, the module rear efficiency as a proportion of the front efficiency subject to the same irradiance. Used to calculate the module rear production for bifacial systems.
pvrow_heightThe height of the module rows, in metres, measured from the ground to the row center or axis. Used to calculate the module rear incident irradiance and production for bifacial systems.
pvrow_widthThe width of the module rows, in metres. This is the cross-section width of the entire PV row. Used to calculate the module rear incident irradiance and production for bifacial systems.
clearsky_zenith_coefficientsCoefficients used to model clear-sky solar zenith irradiance for the resource.
view definition
day_of_yearsigned_zenith_coefficientscloudy_zenith_coefficientsCoefficients used to model cloudy-sky solar zenith irradiance for the resource.
view definition
day_of_yearsigned_zenith_coefficientsResponses
200OK
PvPowerResource▼
OK
resource_idnamelatitudelongitudecapacitycapacity_dcazimuthtilttracking_typeinstall_dategrid_export_limitmodule_typeground_coverage_ratioderating_temp_modulederating_age_systemderating_other_systeminverter_peak_efficiencytracker_axis_azimuthtracker_max_rotation_angletracker_back_trackingtracker_smart_trackingterrain_slopeterrain_azimuthdust_soiling_averagebifacial_systemsite_ground_albedobifaciality_factorpvrow_heightpvrow_widthclearsky_zenith_coefficientsZenithCoefficients[]optionalview definition
Coefficients used to model clear-sky solar zenith irradiance for the resource.
day_of_yearsigned_zenith_coefficientscloudy_zenith_coefficientsZenithCoefficients[]optionalview definition
Coefficients used to model cloudy-sky solar zenith irradiance for the resource.
day_of_yearsigned_zenith_coefficientsPOST/resources/pv_power_site
curl -X POST "https://api.solcast.com.au/resources/pv_power_site" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"entitlement": "advanced",
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"name": "My Site",
"latitude": -33.865,
"longitude": 151.209,
"capacity": 5,
"capacity_dc": 5,
"azimuth": 0,
"tilt": 20,
"tracking_type": "string",
"install_date": "2024-07-01T00:00:00.0000000Z",
"grid_export_limit": 1,
"module_type": "string",
"ground_coverage_ratio": 1,
"derating_temp_module": 1,
"derating_age_system": 1,
"derating_other_system": 1,
"inverter_peak_efficiency": 1,
"tracker_axis_azimuth": 0,
"tracker_max_rotation_angle": 1,
"tracker_back_tracking": true,
"tracker_smart_tracking": true,
"terrain_slope": 1,
"terrain_azimuth": 0,
"dust_soiling_average": [
1
],
"bifacial_system": true,
"site_ground_albedo": 1,
"bifaciality_factor": 1,
"pvrow_height": 1,
"pvrow_width": 1,
"clearsky_zenith_coefficients": [
{
"day_of_year": 42,
"signed_zenith_coefficients": {}
}
],
"cloudy_zenith_coefficients": [
{
"day_of_year": 42,
"signed_zenith_coefficients": {}
}
]
}'{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"name": "My Site",
"latitude": -33.865,
"longitude": 151.209,
"capacity": 5,
"capacity_dc": 5,
"azimuth": 0,
"tilt": 20,
"tracking_type": "string",
"install_date": "2024-07-01T00:00:00.0000000Z",
"grid_export_limit": 1,
"module_type": "string",
"ground_coverage_ratio": 1,
"derating_temp_module": 1,
"derating_age_system": 1,
"derating_other_system": 1,
"inverter_peak_efficiency": 1,
"tracker_axis_azimuth": 0,
"tracker_max_rotation_angle": 1,
"tracker_back_tracking": true,
"tracker_smart_tracking": true,
"terrain_slope": 1,
"terrain_azimuth": 0,
"dust_soiling_average": [
1
],
"bifacial_system": true,
"site_ground_albedo": 1,
"bifaciality_factor": 1,
"pvrow_height": 1,
"pvrow_width": 1,
"clearsky_zenith_coefficients": [
{
"day_of_year": 42,
"signed_zenith_coefficients": {}
}
],
"cloudy_zenith_coefficients": [
{
"day_of_year": 42,
"signed_zenith_coefficients": {}
}
]
}Get Resource
Query Parameters
1 fieldresource_idrequiredThe unique identifier of the resource.
Responses
200OK
PvPowerResource▼
OK
resource_idnamelatitudelongitudecapacitycapacity_dcazimuthtilttracking_typeinstall_dategrid_export_limitmodule_typeground_coverage_ratioderating_temp_modulederating_age_systemderating_other_systeminverter_peak_efficiencytracker_axis_azimuthtracker_max_rotation_angletracker_back_trackingtracker_smart_trackingterrain_slopeterrain_azimuthdust_soiling_averagebifacial_systemsite_ground_albedobifaciality_factorpvrow_heightpvrow_widthclearsky_zenith_coefficientsZenithCoefficients[]optionalview definition
Coefficients used to model clear-sky solar zenith irradiance for the resource.
day_of_yearsigned_zenith_coefficientscloudy_zenith_coefficientsZenithCoefficients[]optionalview definition
Coefficients used to model cloudy-sky solar zenith irradiance for the resource.
day_of_yearsigned_zenith_coefficientsGET/resources/pv_power_site
curl -X GET "https://api.solcast.com.au/resources/pv_power_site?resource_id=ba75-e17a-7374-95ed" \
-H "Authorization: Bearer $API_KEY"{
"resource_id": "ba75-e17a-7374-95ed",
"name": "Test Site: Sydney Opera House",
"latitude": -33.856784,
"longitude": 151.215297,
"capacity": 10,
"capacity_dc": 15,
"azimuth": 0,
"tilt": 30.22,
"tracking_type": "horizontal_single_axis",
"install_date": "2021-07-01T00:00:00.0000000Z",
"module_type": "poly-si",
"ground_coverage_ratio": 0.47,
"derating_temp_module": 0.0039,
"derating_age_system": 0.0059,
"derating_other_system": 0.07,
"inverter_peak_efficiency": 0.985,
"tracker_axis_azimuth": 0,
"tracker_max_rotation_angle": 60,
"tracker_back_tracking": true,
"tracker_smart_tracking": false,
"terrain_slope": 0,
"terrain_azimuth": 0,
"dust_soiling_average": [
0.015,
0.015,
0.015
],
"bifacial_system": false,
"site_ground_albedo": 0.25,
"bifaciality_factor": 0.7,
"pvrow_height": 1.5,
"pvrow_width": 2,
"confirmed_metadata": "2024-07-30T11:52:28.9964540Z"
}Patch Resource
Request Body
31 fieldsresource_idrequiredThe unique identifier of the resource.
namerequiredThe name of the resource.
latituderequiredThe latitude of the resource. Must be a decimal number between -90 and 90.
longituderequiredThe longitude of the resource. Must be a decimal number between -180 and 180.
capacityTotal inverter (nameplate) capacity in MW. This is the highest potential output of the system before any Site Export Limit is applied. It is used to model the conversion of DC power to AC by your inverters.
capacity_dcTotal module capacity in MW. Usually slightly higher than the AC capacity. It is used to model the generation of DC power by your modules.
azimuthThe angle from true north the modules are facing. North is 0, South is ±180, Eastward facing is negative values. Westward facing is positive values. For example, -90 is due east. It is used to calculate the incident irradiance for your modules.
tiltThe off-horizontal tilt angle of modules for a fixed-tilt site.
tracking_typeThe type of sun-tracking or geometry configuration of your site's modules. It is used to calculate the incident irradiance for your modules.
install_dateThe date when your site was installed. It is used to derate your module (DC) production gradually with age, at a rate dependent on your Module Type.
grid_export_limitThe maximum power export limit in MW that is allowed by the site’s connection with the network operator. It is used to place a final cap on your AC power output. Only impacts your AC power if the grid export limit is set lower than the AC capacity.
module_typeThe type of material or technology used in your site's PV modules. It is used to estimate your module temperature derating coefficient (unless you specify your own coefficient), and used to estimate your module age derating.
ground_coverage_ratioThe proportion of the site's ground area covered by modules. It is used to calculate the incident irradiance for your modules.
derating_temp_moduleThe factor by which your site’s module (DC) production varies with differences in temperature from standard operating conditions ( 25 oC ). Can be found on module spec sheets and its often referred as: temperature coefficient of power or pmp.
derating_age_systemThe factor by which the whole system will be derated per year since Install Date. It is used to calculate time dependent system loss.
derating_other_systemThe total system losses as a fraction of the total energy output. This excludes shading, soiling, snow, inverter, temperature and age. Includes losses such as wiring.
inverter_peak_efficiencyThe peak efficiency value in your inverter efficiency curve. It is used to scale the conversion efficiency of DC to AC, as a function of the inverter load.
tracker_axis_azimuthThe off north-south azimuth angle for a horizontal single axis tracking site. Most commonly this will be close to zero. North is 0, South is ±180, Eastward facing is negative values. Westward facing is positive values. For example, -90 is due east. It is used to calculate the incident irradiance for your modules.
tracker_max_rotation_angleThe maximum off-horizontal angle for a horizontal single axis tracking site. It is used to calculate the incident irradiance for your modules.
tracker_back_trackingWhether the trackers backtrack at low solar elevation angles, for a horizontal single axis tracking site. It is used to calculate the incident irradiance for your modules.
tracker_smart_trackingWhether the trackers move to horizontal during cloudy periods with zero DNI, for a horizontal single axis tracking site. It is used to calculate the incident irradiance for your modules.
terrain_slopeThe average terrain slope in degrees from horizontal of your site. A site with no terrain slope has a value of zero.
terrain_azimuthThe average terrain slope downhill direction. North is 0, South is ±180, Eastward is negative values. Westward is positive values. For example, -90 is due east. It is used to calculate the incident irradiance for your modules.
dust_soiling_averageThe average proportion of module production lost due to dust soiling. The value entered should reflect the impact of cleaning activity at your site. It is used to calculate the module (DC) production.
bifacial_systemBifacial systems have modules that produce solar power not only from the front, but also the rear side of the panel. Used to create additional parameters that will allow us to model your production more accurately.
site_ground_albedoThe proportion of the incident downward irradiance reflected by the ground surface in the area underneath the PV modules. Used to calculate local ground-reflected irradiance. Particularly important for bifacial systems.
bifaciality_factorFor bifacial modules, the module rear efficiency as a proportion of the front efficiency subject to the same irradiance. Used to calculate the module rear production for bifacial systems.
pvrow_heightThe height of the module rows, in metres, measured from the ground to the row center or axis. Used to calculate the module rear incident irradiance and production for bifacial systems.
pvrow_widthThe width of the module rows, in metres. This is the cross-section width of the entire PV row. Used to calculate the module rear incident irradiance and production for bifacial systems.
clearsky_zenith_coefficientsCoefficients used to model clear-sky solar zenith irradiance for the resource.
view definition
day_of_yearsigned_zenith_coefficientscloudy_zenith_coefficientsCoefficients used to model cloudy-sky solar zenith irradiance for the resource.
view definition
day_of_yearsigned_zenith_coefficientsResponses
200OK
PvPowerResource▼
OK
resource_idnamelatitudelongitudecapacitycapacity_dcazimuthtilttracking_typeinstall_dategrid_export_limitmodule_typeground_coverage_ratioderating_temp_modulederating_age_systemderating_other_systeminverter_peak_efficiencytracker_axis_azimuthtracker_max_rotation_angletracker_back_trackingtracker_smart_trackingterrain_slopeterrain_azimuthdust_soiling_averagebifacial_systemsite_ground_albedobifaciality_factorpvrow_heightpvrow_widthclearsky_zenith_coefficientsZenithCoefficients[]optionalview definition
Coefficients used to model clear-sky solar zenith irradiance for the resource.
day_of_yearsigned_zenith_coefficientscloudy_zenith_coefficientsZenithCoefficients[]optionalview definition
Coefficients used to model cloudy-sky solar zenith irradiance for the resource.
day_of_yearsigned_zenith_coefficientsPATCH/resources/pv_power_site
curl -X PATCH "https://api.solcast.com.au/resources/pv_power_site" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"name": "My Site",
"latitude": -33.865,
"longitude": 151.209,
"capacity": 5,
"capacity_dc": 5,
"azimuth": 0,
"tilt": 20,
"tracking_type": "string",
"install_date": "2024-07-01T00:00:00.0000000Z",
"grid_export_limit": 1,
"module_type": "string",
"ground_coverage_ratio": 1,
"derating_temp_module": 1,
"derating_age_system": 1,
"derating_other_system": 1,
"inverter_peak_efficiency": 1,
"tracker_axis_azimuth": 0,
"tracker_max_rotation_angle": 1,
"tracker_back_tracking": true,
"tracker_smart_tracking": true,
"terrain_slope": 1,
"terrain_azimuth": 0,
"dust_soiling_average": [
1
],
"bifacial_system": true,
"site_ground_albedo": 1,
"bifaciality_factor": 1,
"pvrow_height": 1,
"pvrow_width": 1,
"clearsky_zenith_coefficients": [
{
"day_of_year": 42,
"signed_zenith_coefficients": {}
}
],
"cloudy_zenith_coefficients": [
{
"day_of_year": 42,
"signed_zenith_coefficients": {}
}
]
}'{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"name": "My Site",
"latitude": -33.865,
"longitude": 151.209,
"capacity": 5,
"capacity_dc": 5,
"azimuth": 0,
"tilt": 20,
"tracking_type": "string",
"install_date": "2024-07-01T00:00:00.0000000Z",
"grid_export_limit": 1,
"module_type": "string",
"ground_coverage_ratio": 1,
"derating_temp_module": 1,
"derating_age_system": 1,
"derating_other_system": 1,
"inverter_peak_efficiency": 1,
"tracker_axis_azimuth": 0,
"tracker_max_rotation_angle": 1,
"tracker_back_tracking": true,
"tracker_smart_tracking": true,
"terrain_slope": 1,
"terrain_azimuth": 0,
"dust_soiling_average": [
1
],
"bifacial_system": true,
"site_ground_albedo": 1,
"bifaciality_factor": 1,
"pvrow_height": 1,
"pvrow_width": 1,
"clearsky_zenith_coefficients": [
{
"day_of_year": 42,
"signed_zenith_coefficients": {}
}
],
"cloudy_zenith_coefficients": [
{
"day_of_year": 42,
"signed_zenith_coefficients": {}
}
]
}Update Resource
Request Body
31 fieldsresource_idrequiredThe unique identifier of the resource.
namerequiredThe name of the resource.
latituderequiredThe latitude of the resource. Must be a decimal number between -90 and 90.
longituderequiredThe longitude of the resource. Must be a decimal number between -180 and 180.
capacityTotal inverter (nameplate) capacity in MW. This is the highest potential output of the system before any Site Export Limit is applied. It is used to model the conversion of DC power to AC by your inverters.
capacity_dcTotal module capacity in MW. Usually slightly higher than the AC capacity. It is used to model the generation of DC power by your modules.
azimuthThe angle from true north the modules are facing. North is 0, South is ±180, Eastward facing is negative values. Westward facing is positive values. For example, -90 is due east. It is used to calculate the incident irradiance for your modules.
tiltThe off-horizontal tilt angle of modules for a fixed-tilt site.
tracking_typeThe type of sun-tracking or geometry configuration of your site's modules. It is used to calculate the incident irradiance for your modules.
install_dateThe date when your site was installed. It is used to derate your module (DC) production gradually with age, at a rate dependent on your Module Type.
grid_export_limitThe maximum power export limit in MW that is allowed by the site’s connection with the network operator. It is used to place a final cap on your AC power output. Only impacts your AC power if the grid export limit is set lower than the AC capacity.
module_typeThe type of material or technology used in your site's PV modules. It is used to estimate your module temperature derating coefficient (unless you specify your own coefficient), and used to estimate your module age derating.
ground_coverage_ratioThe proportion of the site's ground area covered by modules. It is used to calculate the incident irradiance for your modules.
derating_temp_moduleThe factor by which your site’s module (DC) production varies with differences in temperature from standard operating conditions ( 25 oC ). Can be found on module spec sheets and its often referred as: temperature coefficient of power or pmp.
derating_age_systemThe factor by which the whole system will be derated per year since Install Date. It is used to calculate time dependent system loss.
derating_other_systemThe total system losses as a fraction of the total energy output. This excludes shading, soiling, snow, inverter, temperature and age. Includes losses such as wiring.
inverter_peak_efficiencyThe peak efficiency value in your inverter efficiency curve. It is used to scale the conversion efficiency of DC to AC, as a function of the inverter load.
tracker_axis_azimuthThe off north-south azimuth angle for a horizontal single axis tracking site. Most commonly this will be close to zero. North is 0, South is ±180, Eastward facing is negative values. Westward facing is positive values. For example, -90 is due east. It is used to calculate the incident irradiance for your modules.
tracker_max_rotation_angleThe maximum off-horizontal angle for a horizontal single axis tracking site. It is used to calculate the incident irradiance for your modules.
tracker_back_trackingWhether the trackers backtrack at low solar elevation angles, for a horizontal single axis tracking site. It is used to calculate the incident irradiance for your modules.
tracker_smart_trackingWhether the trackers move to horizontal during cloudy periods with zero DNI, for a horizontal single axis tracking site. It is used to calculate the incident irradiance for your modules.
terrain_slopeThe average terrain slope in degrees from horizontal of your site. A site with no terrain slope has a value of zero.
terrain_azimuthThe average terrain slope downhill direction. North is 0, South is ±180, Eastward is negative values. Westward is positive values. For example, -90 is due east. It is used to calculate the incident irradiance for your modules.
dust_soiling_averageThe average proportion of module production lost due to dust soiling. The value entered should reflect the impact of cleaning activity at your site. It is used to calculate the module (DC) production.
bifacial_systemBifacial systems have modules that produce solar power not only from the front, but also the rear side of the panel. Used to create additional parameters that will allow us to model your production more accurately.
site_ground_albedoThe proportion of the incident downward irradiance reflected by the ground surface in the area underneath the PV modules. Used to calculate local ground-reflected irradiance. Particularly important for bifacial systems.
bifaciality_factorFor bifacial modules, the module rear efficiency as a proportion of the front efficiency subject to the same irradiance. Used to calculate the module rear production for bifacial systems.
pvrow_heightThe height of the module rows, in metres, measured from the ground to the row center or axis. Used to calculate the module rear incident irradiance and production for bifacial systems.
pvrow_widthThe width of the module rows, in metres. This is the cross-section width of the entire PV row. Used to calculate the module rear incident irradiance and production for bifacial systems.
clearsky_zenith_coefficientsCoefficients used to model clear-sky solar zenith irradiance for the resource.
view definition
day_of_yearsigned_zenith_coefficientscloudy_zenith_coefficientsCoefficients used to model cloudy-sky solar zenith irradiance for the resource.
view definition
day_of_yearsigned_zenith_coefficientsResponses
200OK
PvPowerResource▼
OK
resource_idnamelatitudelongitudecapacitycapacity_dcazimuthtilttracking_typeinstall_dategrid_export_limitmodule_typeground_coverage_ratioderating_temp_modulederating_age_systemderating_other_systeminverter_peak_efficiencytracker_axis_azimuthtracker_max_rotation_angletracker_back_trackingtracker_smart_trackingterrain_slopeterrain_azimuthdust_soiling_averagebifacial_systemsite_ground_albedobifaciality_factorpvrow_heightpvrow_widthclearsky_zenith_coefficientsZenithCoefficients[]optionalview definition
Coefficients used to model clear-sky solar zenith irradiance for the resource.
day_of_yearsigned_zenith_coefficientscloudy_zenith_coefficientsZenithCoefficients[]optionalview definition
Coefficients used to model cloudy-sky solar zenith irradiance for the resource.
day_of_yearsigned_zenith_coefficientsPUT/resources/pv_power_site
curl -X PUT "https://api.solcast.com.au/resources/pv_power_site" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"name": "My Site",
"latitude": -33.865,
"longitude": 151.209,
"capacity": 5,
"capacity_dc": 5,
"azimuth": 0,
"tilt": 20,
"tracking_type": "string",
"install_date": "2024-07-01T00:00:00.0000000Z",
"grid_export_limit": 1,
"module_type": "string",
"ground_coverage_ratio": 1,
"derating_temp_module": 1,
"derating_age_system": 1,
"derating_other_system": 1,
"inverter_peak_efficiency": 1,
"tracker_axis_azimuth": 0,
"tracker_max_rotation_angle": 1,
"tracker_back_tracking": true,
"tracker_smart_tracking": true,
"terrain_slope": 1,
"terrain_azimuth": 0,
"dust_soiling_average": [
1
],
"bifacial_system": true,
"site_ground_albedo": 1,
"bifaciality_factor": 1,
"pvrow_height": 1,
"pvrow_width": 1,
"clearsky_zenith_coefficients": [
{
"day_of_year": 42,
"signed_zenith_coefficients": {}
}
],
"cloudy_zenith_coefficients": [
{
"day_of_year": 42,
"signed_zenith_coefficients": {}
}
]
}'{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"name": "My Site",
"latitude": -33.865,
"longitude": 151.209,
"capacity": 5,
"capacity_dc": 5,
"azimuth": 0,
"tilt": 20,
"tracking_type": "string",
"install_date": "2024-07-01T00:00:00.0000000Z",
"grid_export_limit": 1,
"module_type": "string",
"ground_coverage_ratio": 1,
"derating_temp_module": 1,
"derating_age_system": 1,
"derating_other_system": 1,
"inverter_peak_efficiency": 1,
"tracker_axis_azimuth": 0,
"tracker_max_rotation_angle": 1,
"tracker_back_tracking": true,
"tracker_smart_tracking": true,
"terrain_slope": 1,
"terrain_azimuth": 0,
"dust_soiling_average": [
1
],
"bifacial_system": true,
"site_ground_albedo": 1,
"bifaciality_factor": 1,
"pvrow_height": 1,
"pvrow_width": 1,
"clearsky_zenith_coefficients": [
{
"day_of_year": 42,
"signed_zenith_coefficients": {}
}
],
"cloudy_zenith_coefficients": [
{
"day_of_year": 42,
"signed_zenith_coefficients": {}
}
]
}Remove Resource
Query Parameters
1 fieldresource_idrequiredThe unique identifier of the resource.
Responses
204No Content
▼
No Content
DELETE/resources/pv_power_site
curl -X DELETE "https://api.solcast.com.au/resources/pv_power_site?resource_id=ba75-e17a-7374-95ed" \
-H "Authorization: Bearer $API_KEY"Retrieve Current Schedule
Retrieve the current availability and curtailment schedule for a premium resource. Use issue_time to query historical schedule state.
Query Parameters
3 fieldsresource_idrequiredThe resource id.
period_startrequiredStart of the query window (ISO 8601). Must be on a 5-minute boundary.
period_endrequiredEnd of the query window (ISO 8601). Must be on a 5-minute boundary.
Responses
200OK
ResourceScheduleResponse▼
OK
availability_scheduleAvailabilityIntervalDto[]optionalview definition
period_startperiod_endavailabilitycurtailment_scheduleCurtailmentIntervalDto[]optionalview definition
period_startperiod_endcurtailmentresponse_statusResponseStatusoptionalview definition
error_codemessagestack_traceerrorsResponseError[]optionalview definition
error_codefield_namemessagemetametaGET/manage/schedules
curl -X GET "https://api.solcast.com.au/manage/schedules?resource_id=cbf6-a872-1cb2-566f&period_start=2026-01-01T00:00:00.0000000Z&period_end=2026-01-02T00:00:00.0000000Z&issue_time=<issue_time>" \
-H "Authorization: Bearer $API_KEY"{
"availability_schedule": [],
"curtailment_schedule": []
}Patch Schedule Intervals
Merge new availability and/or curtailment schedule intervals into the existing stored schedule for a premium resource. Overlapping intervals are replaced (existing intervals are split as needed). The request is all-or-nothing: a validation error in any entry rejects the entire request.
Request Body
3 fieldsresource_idrequiredThe resource id.
availability_scheduleAvailability schedule entries to merge.
view definition
period_startperiod_endavailabilitycurtailmentcurtailment_scheduleCurtailment schedule entries to merge.
view definition
period_startperiod_endavailabilitycurtailmentResponses
200OK
PatchResourceScheduleResponse▼
OK
response_statusResponseStatusoptionalview definition
error_codemessagestack_traceerrorsResponseError[]optionalview definition
error_codefield_namemessagemetametaPATCH/manage/schedules
curl -X PATCH "https://api.solcast.com.au/manage/schedules" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"availability_schedule": [
{
"period_start": "string",
"period_end": "2024-07-01T00:00:00.0000000Z",
"availability": 1,
"curtailment": 1
}
],
"curtailment_schedule": [
{
"period_start": "string",
"period_end": "2024-07-01T00:00:00.0000000Z",
"availability": 1,
"curtailment": 1
}
]
}'{
"response_status": {
"error_code": "string",
"message": "string",
"stack_trace": "string",
"errors": [
{
"error_code": null,
"field_name": null,
"message": null,
"meta": null
}
],
"meta": {}
}
}Remove Schedule Data
Remove stored schedule data for the given time window and schedule type(s). Intervals extending beyond the window are trimmed; intervals entirely within are dropped.
Query Parameters
4 fieldsresource_idrequiredThe resource id.
period_startrequiredStart of the delete window (ISO 8601). Must be on a 5-minute boundary.
period_endrequiredEnd of the delete window (ISO 8601). Must be on a 5-minute boundary.
schedule_typerequiredComma-separated list of schedule types to delete: availability, curtailment
Responses
200OK
DeleteResourceScheduleResponse▼
OK
response_statusResponseStatusoptionalview definition
error_codemessagestack_traceerrorsResponseError[]optionalview definition
error_codefield_namemessagemetametaDELETE/manage/schedules
curl -X DELETE "https://api.solcast.com.au/manage/schedules?resource_id=cbf6-a872-1cb2-566f&period_start=2026-01-01T00:00:00.0000000Z&period_end=2026-01-02T00:00:00.0000000Z&schedule_type=<schedule_type>" \
-H "Authorization: Bearer $API_KEY"{
"response_status": {
"error_code": "string",
"message": "string",
"stack_trace": "string",
"errors": [
{
"error_code": null,
"field_name": null,
"message": null,
"meta": null
}
],
"meta": {}
}
}Get Forecast Premium Wind
Query Parameters
5 fieldsresource_idrequiredThe resource id of the resource.
hoursThe number of hours to return in the response.
periodLength of the averaging period in ISO 8601 duration format. Default is PT30M.
output_parametersThe output parameters to include in the response. Any p-level variant (1-99, up to one decimal place; no decimal point for whole numbers) of a p-capable base is also accepted if present on your plan (e.g. power_p70, power_p77.5, curtailed_power_p20, wind_speed_hub_height_p35).
formatResponse format. Default is HTML if not supplied.
Responses
200OK
ForecastPremiumWindPowerResponse▼
OK
forecastsGET/data/forecast/premium_wind_power
curl -X GET "https://api.solcast.com.au/data/forecast/premium_wind_power?resource_id=c533-fbce-05b5-b3ef&output_parameters=power&period=PT60M&hours=24" \
-H "Authorization: Bearer $API_KEY"{
"forecasts": [
{
"power": 0.5386,
"period_end": "2026-07-30T01:00:00+00:00",
"period": "PT60M"
},
{
"power": 0.3185,
"period_end": "2026-07-30T02:00:00+00:00",
"period": "PT60M"
},
{
"power": 0.2953,
"period_end": "2026-07-30T03:00:00+00:00",
"period": "PT60M"
}
]
}Create Site Measurements
Submit measurement data for a Premium Wind Power site. Measurements are used for model training. Maximum 1000 measurements per request. Power units (AC) are measured in MW.
Request Body
2 fieldsresource_idrequiredThe unique identifier of the Premium Wind Power resource.
measurementsArray of measurement records (1-1000).
view definition
availabilitycurtailmentperiodperiod_endperiod_startpowerwind_direction_hub_heightwind_speed_hub_heightResponses
200OK
CreateSiteMeasurementsResponse▼
OK
resource_idacceptedresponse_statusResponseStatusoptionalview definition
error_codemessagestack_traceerrorsResponseError[]optionalview definition
error_codefield_namemessagemetametaPOST/resources/wind_power_site_measurements
curl -X POST "https://api.solcast.com.au/resources/wind_power_site_measurements" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"measurements": [
{
"availability": 1,
"curtailment": 1,
"period": "string",
"period_end": "2024-07-01T00:00:00.0000000Z",
"period_start": "string",
"power": 1,
"wind_direction_hub_height": 1,
"wind_speed_hub_height": 1
}
],
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde"
}'{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"accepted": 42,
"response_status": {
"error_code": "string",
"message": "string",
"stack_trace": "string",
"errors": [
{
"error_code": null,
"field_name": null,
"message": null,
"meta": null
}
],
"meta": {}
}
}Retrieve Site Measurements
Retrieve historical measurement data for a Premium Wind Power site. Supports pagination via skip/take and date filtering via start/end.
Query Parameters
4 fieldsresource_idrequiredThe unique identifier of the Premium Wind Power resource.
startFilter: period_end >= start (ISO-8601).
endFilter: period_end <= end (ISO-8601).
formatResponse format. Default is HTML if not supplied.
Responses
200OK
QueryResponse_WindSiteMeasurement▼
OK
offsettotalresultsWindSiteMeasurement[]optionalview definition
idwind_site_idperiod_endperiodcreatedtotal_poweravailabilityconstraint_power_ceilingwind_speed_hub_heightwind_direction_hub_heightmetaresponse_statusResponseStatusoptionalview definition
error_codemessagestack_traceerrorsResponseError[]optionalview definition
error_codefield_namemessagemetametaGET/resources/wind_power_site_measurements
curl -X GET "https://api.solcast.com.au/resources/wind_power_site_measurements?resource_id=c533-fbce-05b5-b3ef&start=2026-01-01&end=<end>" \
-H "Authorization: Bearer $API_KEY"{
"offset": 0,
"total": 0,
"results": []
}List Resources
Lists all premium wind power sites accessible to the authenticated user.
Query Parameters
5 fieldsstartFilter to sites created on or after this date (ISO 8601 format).
endFilter to sites created before this date (ISO 8601 format).
show_allWhen true, returns all sites in the system. Requires admin privileges.
querySearch query for site name or resource ID.
forecast_productionFilter to sites where ML forecast production is enabled.
Responses
200OK
QueryResponse_PremiumWindPowerResource▼
OK
offsettotalresultsPremiumWindPowerResource[]optionalview definition
resource_idnamelatitudelongitudecapacityrotor_diameterrated_powerhub_heightnumber_of_turbinescut_in_wind_speedcut_out_wind_speedrated_wind_speedmetaresponse_statusResponseStatusoptionalview definition
error_codemessagestack_traceerrorsResponseError[]optionalview definition
error_codefield_namemessagemetametaGET/resources/wind_power_sites
curl -X GET "https://api.solcast.com.au/resources/wind_power_sites?show_all=<show_all>&query=<query>" \
-H "Authorization: Bearer $API_KEY"{
"offset": 0,
"total": 1,
"results": [
{
"resource_id": "c533-fbce-05b5-b3ef",
"name": "GDP - Postman Test Site",
"latitude": 36.5,
"longitude": -5.5,
"capacity": 14,
"rotor_diameter": 90,
"rated_power": 2,
"hub_height": 100,
"number_of_turbines": 7,
"cut_in_wind_speed": 3,
"cut_out_wind_speed": 25,
"rated_wind_speed": 13.5
}
]
}Create Resource
Create a new premium wind power site. Required fields: name, latitude, longitude, capacity. Optional fields with defaults: rotor_diameter (100m), hub_height (80m), number_of_turbines (1), cut_in_wind_speed (3 m/s), cut_out_wind_speed (25 m/s), rated_wind_speed (12 m/s).
Request Body
12 fieldsresource_idrequiredThe unique identifier of the resource.
namerequiredThe name of the resource.
latituderequiredThe latitude of the resource. Must be a decimal number between -90 and 90.
longituderequiredThe longitude of the resource. Must be a decimal number between -180 and 180.
capacityrequiredThe site capacity (rated power × number of turbines) in MW.
rotor_diameterAverage diameter of turbine rotor in metres. Must be between 20 and 200.
rated_powerAverage turbine rated power in MW. Must be between 0.1 and 15000.
hub_heightAverage height of turbine hub in metres. Must be between 10 and 200. Defaults to 80.
number_of_turbinesTotal number of turbines at site. Must be between 1 and 500. Defaults to 1.
cut_in_wind_speedMinimum wind speed for generation in m/s. Must be between 0 and 10. Defaults to 3.
cut_out_wind_speedMaximum wind speed before shutdown in m/s. Must be between 15 and 35. Defaults to 25.
rated_wind_speedWind speed at rated power in m/s. Must be between 8 and 20. Defaults to 12.
Responses
200OK
PremiumWindPowerResource▼
OK
resource_idnamelatitudelongitudecapacityrotor_diameterrated_powerhub_heightnumber_of_turbinescut_in_wind_speedcut_out_wind_speedrated_wind_speedPOST/resources/wind_power_site
curl -X POST "https://api.solcast.com.au/resources/wind_power_site" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"name": "My Site",
"latitude": -33.865,
"longitude": 151.209,
"capacity": 5,
"rotor_diameter": 1,
"rated_power": 1,
"hub_height": 1,
"number_of_turbines": 42,
"cut_in_wind_speed": 1,
"cut_out_wind_speed": 1,
"rated_wind_speed": 1
}'{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"name": "My Site",
"latitude": -33.865,
"longitude": 151.209,
"capacity": 5,
"rotor_diameter": 1,
"rated_power": 1,
"hub_height": 1,
"number_of_turbines": 42,
"cut_in_wind_speed": 1,
"cut_out_wind_speed": 1,
"rated_wind_speed": 1
}Get Resource
Retrieve details of a specific premium wind power site.
Query Parameters
1 fieldresource_idrequiredThe unique identifier of the resource.
Responses
200OK
PremiumWindPowerResource▼
OK
resource_idnamelatitudelongitudecapacityrotor_diameterrated_powerhub_heightnumber_of_turbinescut_in_wind_speedcut_out_wind_speedrated_wind_speedGET/resources/wind_power_site
curl -X GET "https://api.solcast.com.au/resources/wind_power_site?resource_id=c533-fbce-05b5-b3ef" \
-H "Authorization: Bearer $API_KEY"{
"resource_id": "c533-fbce-05b5-b3ef",
"name": "GDP - Postman Test Site",
"latitude": 36.5,
"longitude": -5.5,
"capacity": 14,
"rotor_diameter": 90,
"rated_power": 2,
"hub_height": 100,
"number_of_turbines": 7,
"cut_in_wind_speed": 3,
"cut_out_wind_speed": 25,
"rated_wind_speed": 13.5
}Patch Resource
Partially update a premium wind power site. Only fields included in the body are updated. All body fields: resource_id (required), name, latitude, longitude, capacity, rotor_diameter (20-200), rated_power (0.1-15000), hub_height (10-200), number_of_turbines (1-500), cut_in_wind_speed (0-10), cut_out_wind_speed (15-35), rated_wind_speed (8-20).
Request Body
12 fieldsresource_idrequiredThe unique identifier of the resource.
namerequiredThe name of the resource.
latituderequiredThe latitude of the resource. Must be a decimal number between -90 and 90.
longituderequiredThe longitude of the resource. Must be a decimal number between -180 and 180.
capacityrequiredThe site capacity (rated power × number of turbines) in MW.
rotor_diameterAverage diameter of turbine rotor in metres. Must be between 20 and 200.
rated_powerAverage turbine rated power in MW. Must be between 0.1 and 15000.
hub_heightAverage height of turbine hub in metres. Must be between 10 and 200. Defaults to 80.
number_of_turbinesTotal number of turbines at site. Must be between 1 and 500. Defaults to 1.
cut_in_wind_speedMinimum wind speed for generation in m/s. Must be between 0 and 10. Defaults to 3.
cut_out_wind_speedMaximum wind speed before shutdown in m/s. Must be between 15 and 35. Defaults to 25.
rated_wind_speedWind speed at rated power in m/s. Must be between 8 and 20. Defaults to 12.
Responses
200OK
PremiumWindPowerResource▼
OK
resource_idnamelatitudelongitudecapacityrotor_diameterrated_powerhub_heightnumber_of_turbinescut_in_wind_speedcut_out_wind_speedrated_wind_speedPATCH/resources/wind_power_site
curl -X PATCH "https://api.solcast.com.au/resources/wind_power_site" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"name": "My Site",
"latitude": -33.865,
"longitude": 151.209,
"capacity": 5,
"rotor_diameter": 1,
"rated_power": 1,
"hub_height": 1,
"number_of_turbines": 42,
"cut_in_wind_speed": 1,
"cut_out_wind_speed": 1,
"rated_wind_speed": 1
}'{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"name": "My Site",
"latitude": -33.865,
"longitude": 151.209,
"capacity": 5,
"rotor_diameter": 1,
"rated_power": 1,
"hub_height": 1,
"number_of_turbines": 42,
"cut_in_wind_speed": 1,
"cut_out_wind_speed": 1,
"rated_wind_speed": 1
}Update Resource
Full replacement update of a premium wind power site. All fields: resource_id (required), name, latitude (-90 to 90), longitude (-180 to 180), capacity (>0 MW), rotor_diameter (20-200m), rated_power (0.1-15000 MW), hub_height (10-200m), number_of_turbines (1-500), cut_in_wind_speed (0-10 m/s), cut_out_wind_speed (15-35 m/s), rated_wind_speed (8-20 m/s).
Request Body
12 fieldsresource_idrequiredThe unique identifier of the resource.
namerequiredThe name of the resource.
latituderequiredThe latitude of the resource. Must be a decimal number between -90 and 90.
longituderequiredThe longitude of the resource. Must be a decimal number between -180 and 180.
capacityrequiredThe site capacity (rated power × number of turbines) in MW.
rotor_diameterAverage diameter of turbine rotor in metres. Must be between 20 and 200.
rated_powerAverage turbine rated power in MW. Must be between 0.1 and 15000.
hub_heightAverage height of turbine hub in metres. Must be between 10 and 200. Defaults to 80.
number_of_turbinesTotal number of turbines at site. Must be between 1 and 500. Defaults to 1.
cut_in_wind_speedMinimum wind speed for generation in m/s. Must be between 0 and 10. Defaults to 3.
cut_out_wind_speedMaximum wind speed before shutdown in m/s. Must be between 15 and 35. Defaults to 25.
rated_wind_speedWind speed at rated power in m/s. Must be between 8 and 20. Defaults to 12.
Responses
200OK
PremiumWindPowerResource▼
OK
resource_idnamelatitudelongitudecapacityrotor_diameterrated_powerhub_heightnumber_of_turbinescut_in_wind_speedcut_out_wind_speedrated_wind_speedPUT/resources/wind_power_site
curl -X PUT "https://api.solcast.com.au/resources/wind_power_site" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"name": "My Site",
"latitude": -33.865,
"longitude": 151.209,
"capacity": 5,
"rotor_diameter": 1,
"rated_power": 1,
"hub_height": 1,
"number_of_turbines": 42,
"cut_in_wind_speed": 1,
"cut_out_wind_speed": 1,
"rated_wind_speed": 1
}'{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"name": "My Site",
"latitude": -33.865,
"longitude": 151.209,
"capacity": 5,
"rotor_diameter": 1,
"rated_power": 1,
"hub_height": 1,
"number_of_turbines": 42,
"cut_in_wind_speed": 1,
"cut_out_wind_speed": 1,
"rated_wind_speed": 1
}Delete Resource
Delete a premium wind power site.
Query Parameters
1 fieldresource_idrequiredThe unique identifier of the resource.
Responses
204No Content
▼
No Content
DELETE/resources/wind_power_site
curl -X DELETE "https://api.solcast.com.au/resources/wind_power_site?resource_id=c533-fbce-05b5-b3ef" \
-H "Authorization: Bearer $API_KEY"Retrieve Current Schedule
Retrieve the current availability and curtailment schedule for a premium resource. Use issue_time to query historical schedule state.
Query Parameters
3 fieldsresource_idrequiredThe resource id.
period_startrequiredStart of the query window (ISO 8601). Must be on a 5-minute boundary.
period_endrequiredEnd of the query window (ISO 8601). Must be on a 5-minute boundary.
Responses
200OK
ResourceScheduleResponse▼
OK
availability_scheduleAvailabilityIntervalDto[]optionalview definition
period_startperiod_endavailabilitycurtailment_scheduleCurtailmentIntervalDto[]optionalview definition
period_startperiod_endcurtailmentresponse_statusResponseStatusoptionalview definition
error_codemessagestack_traceerrorsResponseError[]optionalview definition
error_codefield_namemessagemetametaGET/manage/schedules
curl -X GET "https://api.solcast.com.au/manage/schedules?resource_id=cbf6-a872-1cb2-566f&period_start=2026-01-01T00:00:00.0000000Z&period_end=2026-01-02T00:00:00.0000000Z&issue_time=<issue_time>" \
-H "Authorization: Bearer $API_KEY"{
"availability_schedule": [],
"curtailment_schedule": []
}Patch Schedule Intervals
Merge new availability and/or curtailment schedule intervals into the existing stored schedule for a premium resource. Overlapping intervals are replaced (existing intervals are split as needed). The request is all-or-nothing: a validation error in any entry rejects the entire request.
Request Body
3 fieldsresource_idrequiredThe resource id.
availability_scheduleAvailability schedule entries to merge.
view definition
period_startperiod_endavailabilitycurtailmentcurtailment_scheduleCurtailment schedule entries to merge.
view definition
period_startperiod_endavailabilitycurtailmentResponses
200OK
PatchResourceScheduleResponse▼
OK
response_statusResponseStatusoptionalview definition
error_codemessagestack_traceerrorsResponseError[]optionalview definition
error_codefield_namemessagemetametaPATCH/manage/schedules
curl -X PATCH "https://api.solcast.com.au/manage/schedules" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
"availability_schedule": [
{
"period_start": "string",
"period_end": "2024-07-01T00:00:00.0000000Z",
"availability": 1,
"curtailment": 1
}
],
"curtailment_schedule": [
{
"period_start": "string",
"period_end": "2024-07-01T00:00:00.0000000Z",
"availability": 1,
"curtailment": 1
}
]
}'{
"response_status": {
"error_code": "string",
"message": "string",
"stack_trace": "string",
"errors": [
{
"error_code": null,
"field_name": null,
"message": null,
"meta": null
}
],
"meta": {}
}
}Remove Schedule Data
Remove stored schedule data for the given time window and schedule type(s). Intervals extending beyond the window are trimmed; intervals entirely within are dropped.
Query Parameters
4 fieldsresource_idrequiredThe resource id.
period_startrequiredStart of the delete window (ISO 8601). Must be on a 5-minute boundary.
period_endrequiredEnd of the delete window (ISO 8601). Must be on a 5-minute boundary.
schedule_typerequiredComma-separated list of schedule types to delete: availability, curtailment
Responses
200OK
DeleteResourceScheduleResponse▼
OK
response_statusResponseStatusoptionalview definition
error_codemessagestack_traceerrorsResponseError[]optionalview definition
error_codefield_namemessagemetametaDELETE/manage/schedules
curl -X DELETE "https://api.solcast.com.au/manage/schedules?resource_id=cbf6-a872-1cb2-566f&period_start=2026-01-01T00:00:00.0000000Z&period_end=2026-01-02T00:00:00.0000000Z&schedule_type=<schedule_type>" \
-H "Authorization: Bearer $API_KEY"{
"response_status": {
"error_code": "string",
"message": "string",
"stack_trace": "string",
"errors": [
{
"error_code": null,
"field_name": null,
"message": null,
"meta": null
}
],
"meta": {}
}
}