---
title: "Solar"
method: GET
path: "/v1/assets/solar"
tags: ["On-site assets"]
---

# Solar

`GET /v1/assets/solar`

Read-only solar generation for arrays mapped to a site and its import MPAN. Returns instantaneous AC power, interval generation, yield, and status from the inverter portal. Derived self-consumption and export are labelled as derived.

## Query parameters

- `granularity` 'hour' | 'day' | 'month' | 'year'
- `from` string, date-time
- `to` string, date-time

## Response `200`

Solar systems retrieved successfully

- SolarSystem[]
  - `id` string — Solar system identifier
  - `siteId` string — Site the array is mapped to
  - `importMpan` string — Import MPAN the array offsets
  - `exportMpan` string — Export MPAN if the site has one
  - `installedCapacityKwp` number — Installed capacity in kWp
  - `commissioningDate` string, date — Commissioning date if known
  - `portal` string — OEM or installer monitoring portal
  - `acPowerKw` number — Instantaneous AC power in kW
  - `generationKwh` number — Energy generated in the interval in kWh
  - `lifetimeYieldKwh` number — Lifetime or period yield in kWh
  - `selfConsumedKwh` number — Derived self-consumed generation in kWh
  - `exportedKwh` number — Derived or metered exported generation in kWh
  - `status` 'ONLINE' | 'FAULT' | 'OFFLINE' — Inverter / portal status

## Other responses

- `4XX` — Client error response

## Changes

- **2026-09-02** `58e3dc41902d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/voltview/apis/voltview-api/changes/v1/assets/solar/get.md)

---

[API](https://skmtc.dev/voltview/apis/voltview-api.md) · [All operations](https://skmtc.dev/voltview/apis/voltview-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/voltview/voltview-api/revisions/58e3dc41902d/schema)