---
title: "Retrieve System Loss Settings"
method: GET
path: "/tenants/{tenant_id}/designs/{id}/system_loss_settings"
tags: ["Designs"]
---

# Retrieve System Loss Settings

`GET /tenants/{tenant_id}/designs/{id}/system_loss_settings`

Retrieve the editable per-design system-loss settings: the input derate percentages and
their lock state.

---

These are the **editable inputs** to the performance simulation. They are distinct from the
computed loss waterfall returned under `energy_production.loss_summary` by the
[Design Summary](https://docs.aurorasolar.com/reference/retrievedesignsummary) endpoint, which reports the irradiance/energy
remaining after each stage. Each editable setting maps to exactly one `loss_summary` stage —
see the mapping table on [Update System Loss Settings](https://docs.aurorasolar.com/reference/updatedesignsystemlosssettings).

Values are percentages (e.g. `2.0` represents a 2% loss). Only annual values are supported.

## Path parameters

- `tenant_id` string, uuid, required
- `id` string, uuid, required

## Response `200`

System loss settings successfully retrieved.

- object
  - `system_loss_settings` object
    - `editable` boolean — Whether the losses can be edited. False when a financing product dictates them.
    - `locked_by_financier` string, nullable — The financing product code locking all losses, or null when not financier-locked.
    - `values` object — The editable losses, keyed by loss name. Values are percentages (0-100).
      - `soiling` object
        - `value` number, double — The loss as a percentage (0-100).
        - `locked` boolean — Whether this loss is currently read-only.
        - `disabled_reason` 'financier' | 'shading_engine_enabled', nullable — Why the loss is locked, or null when it is editable.
      - `snow` object
        - `value` number, double — The loss as a percentage (0-100).
        - `locked` boolean — Whether this loss is currently read-only.
        - `disabled_reason` 'financier' | 'shading_engine_enabled', nullable — Why the loss is locked, or null when it is editable.
      - `shading` object
        - `value` number, double — The loss as a percentage (0-100).
        - `locked` boolean — Whether this loss is currently read-only.
        - `disabled_reason` 'financier' | 'shading_engine_enabled', nullable — Why the loss is locked, or null when it is editable.
      - `mismatch` object
        - `value` number, double — The loss as a percentage (0-100).
        - `locked` boolean — Whether this loss is currently read-only.
        - `disabled_reason` 'financier' | 'shading_engine_enabled', nullable — Why the loss is locked, or null when it is editable.
      - `wiring` object
        - `value` number, double — The loss as a percentage (0-100).
        - `locked` boolean — Whether this loss is currently read-only.
        - `disabled_reason` 'financier' | 'shading_engine_enabled', nullable — Why the loss is locked, or null when it is editable.
      - `connections` object
        - `value` number, double — The loss as a percentage (0-100).
        - `locked` boolean — Whether this loss is currently read-only.
        - `disabled_reason` 'financier' | 'shading_engine_enabled', nullable — Why the loss is locked, or null when it is editable.
      - `light_induced_degradation` object
        - `value` number, double — The loss as a percentage (0-100).
        - `locked` boolean — Whether this loss is currently read-only.
        - `disabled_reason` 'financier' | 'shading_engine_enabled', nullable — Why the loss is locked, or null when it is editable.
      - `availability` object
        - `value` number, double — The loss as a percentage (0-100).
        - `locked` boolean — Whether this loss is currently read-only.
        - `disabled_reason` 'financier' | 'shading_engine_enabled', nullable — Why the loss is locked, or null when it is editable.
      - `rating` object
        - `value` number, double — The loss as a percentage (0-100).
        - `locked` boolean — Whether this loss is currently read-only.
        - `disabled_reason` 'financier' | 'shading_engine_enabled', nullable — Why the loss is locked, or null when it is editable.
      - `age` object
        - `value` number, double — The loss as a percentage (0-100).
        - `locked` boolean — Whether this loss is currently read-only.
        - `disabled_reason` 'financier' | 'shading_engine_enabled', nullable — Why the loss is locked, or null when it is editable.
      - `other` object
        - `value` number, double — The loss as a percentage (0-100).
        - `locked` boolean — Whether this loss is currently read-only.
        - `disabled_reason` 'financier' | 'shading_engine_enabled', nullable — Why the loss is locked, or null when it is editable.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/aurorasolar/apis/sync-api.md) · [All operations](https://skmtc.net/aurorasolar/apis/sync-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aurorasolar/sync-api/versions/5b41808d104d/schema)