---
title: "Get Monthly HSU Losses"
method: GET
path: "/data/monthly_averages/soiling/hsu"
tags: ["Soiling Losses"]
---

# Get Monthly HSU Losses

`GET /data/monthly_averages/soiling/hsu`

## Request

- Base URL: `https://api.solcast.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.solcast.com.au/data/monthly_averages/soiling/hsu`
- Auth: none declared

Get the monthly soiling-loss climatology for a site using the HSU model. Returns twelve monthly soiling loss fractions and precipitation totals, with optional fixed or optimised recurring wash schedules. The soiling climatology is calculated with data from 2007 to 2025.

## Query parameters

- `latitude` number, double, nullable, required
- `longitude` number, double, nullable, required
- `tilt` number, double, nullable
- `depo_veloc_pm10` number, double, nullable
- `depo_veloc_pm2_5` number, double, nullable
- `cleaning_threshold` number, double, nullable
- `wash_schedule` WashSchedule: WashSchedule
  - `fixed` FixedWashSchedule: FixedWashSchedule
    - `wash_dates` WashDate[]
      - `month` integer
      - `day` integer
  - `optimized` OptimizedWashSchedule: OptimizedWashSchedule
    - `n_washes` integer
- `format` 'json' | 'csv', nullable

## Response `200`

OK

- HsuMonthlyAveragesDataResponse
  - `monthly_averages` HsuMonthlyAverage[], nullable
    - `month` integer
    - `hsu_loss_fraction` number, double
    - `precip_mm` number, double
  - `wash_dates` WashDate[], nullable
    - `month` integer
    - `day` integer

## Changes

- **2026-09-11** `b4405972f79b`: 1 info
  - endpoint added
- **2026-08-02** `26cf4e29209b`: 1 breaking
  - api path removed without deprecation
- **2026-06-17** `cb83060f93c7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/solcast/apis/solcast-api/changes/data/monthly_averages/soiling/hsu/get.md)

---

[API](https://skmtc.dev/solcast/apis/solcast-api.md) - [All operations](https://skmtc.dev/solcast/apis/solcast-api/llms.txt) - [OpenAPI document](https://skmtc.dev/solcast/apis/solcast-api/revisions/14a1f68f1355?raw)