Sign in
Historic
Soiling Losses

Get Historic HSU Losses

Get historical soiling loss using the HSU model for up to 31 days of data at a time for a requested location. Data is available from 2007-01-01T00:00Z to 7 days ago.

get/data/historic/soiling/hsu

Query parameters

latitudenumber double required

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

longitudenumber double required

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

time_zonestring nullable

Timezone to return in data set. Accepted values are utc, longitudinal, or a range from -13 to 13 in 0.25 hour increments for utc offset. Default is utc.

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

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

depo_veloc_pm10number double nullable

Deposition or settling velocity of PM10 particulates. [m/s]. Default is 0.004.

depo_veloc_pm2.5number double nullable

Deposition or settling velocity of PM2.5 particulates. [m/s]. Default is 0.0009.

tiltnumber double 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.

startstring nullable required

ISO_8601 compliant starting datetime for the historical data. If the supplied value does not specify a timezone, the timezone will be inferred from the time_zone parameter, if supplied. Otherwise UTC is assumed.

durationstring nullable

ISO_8601 compliant duration for the historical data. Must be within 31 days of the start_date. Only one of end or duration should be part of the request.

endstring nullable

ISO_8601 compliant ending datetime for the historical data. Must be within 31 days of the start_date. Only one of end or duration should be part of the request. If the supplied value does not specify a timezone, the timezone will be inferred from the time_zone parameter, if supplied. Otherwise UTC is assumed.

cleaning_thresholdnumber double nullable

Amount of daily rainfall required to clean the panels (mm). Default is 1.0.

initial_soilingnumber double nullable

Initial percentage of energy lost due to soiling at time zero in the rainfall series input. If not provided, Solcast will perform a ramp up series calculation to accurately determine this value. If provided must be >= 0 and < 0.3437.

manual_wash_datesstring[]

Optional. Default is none. A list of ISO_8601 compliant dates or a repeating interval when manual cleaning of the panels occurred. A list of dates example: [2025-01-01,2025-01-05,2025-01-10]. A repeating interval example: R3/2025-01-01T00:00:00Z/P14D. Wash dates outside of the start and end of the request are discarded.

format'json' | 'csv' nullable

Response format. Default is HTML if not supplied.

Response

OK

estimated_actualsobject[] nullable

Changes