Work with DER data
What distributed energy resources data includes, how it syncs, and why it can be empty.
Distributed Energy Resources (DER) data covers on-site generation and storage assets — such as solar panels and batteries — associated with an energy service point. Fiskil retrieves DER data from the institution (in Australia, the energy retailer via CDR) and returns it through GET /v1/energy/der.
What DER data includes
For each service point, DER data can include:
- The number of DER installations at the property
- The installation type (for example solar, battery, or wind)
- Installed generation capacity (kW)
- Storage capacity (kWh) for batteries
- Inverter type and capacity
- Installation date
This data comes from the institution's own records, which are usually captured at installation time — so it may not always reflect the true installed capacity at the property today.
DER sync and webhook
DER data is retrieved on the initial sync after a consent is created, then refreshed on a daily schedule. When new DER data is detected, Fiskil fires the energy.der.sync.completed webhook event.
If a service point has no DER assets, the response may be empty or contain only a service point ID with no installation details. This is not an error — it means the institution has no DER on record for that property.
Webhook firing daily with unchanged data?
If energy.der.sync.completed fires every day for a user whose DER data isn't changing, check whether that user has more than one active consent with the same institution. Duplicate consents trigger independent syncs — one event per consent per day. Revoking the duplicate consents resolves it.
No DER data returned
If DER data is consistently empty for a user with a known solar installation, it can mean:
- The institution has no DER records for that property.
- The DER was installed through a channel that never notified the institution.
- The institution does not yet expose DER data through its data-sharing endpoints.
DER availability depends entirely on what the institution has on record. Fiskil cannot add or modify DER data — it is sourced directly from the institution.
Using DER data
DER data is particularly useful for solar analytics, energy comparison tools, and virtual power plant (VPP) platforms. Combine the installed capacity with usage interval data to estimate generation potential.