Solar Inverters

Solar inverter endpoints cover inventory, production, forecasts, and schedule control for inverters linked to an address.

Base path: /api/v2/addresses/:address_uuid/solar-inverters
Read permission: READ_SOLAR_DATA
Steer permission (schedule writes): STEER_SOLAR_SCHEDULE

What we provide

Inventory and production

Method	Path	Purpose
`GET`	`/`	List solar inverters for the address (includes disconnected history)
`GET`	`/:solar_inverter_uuid`	Get one inverter
`GET`	`/:solar_inverter_uuid/energy/production`	Production readings over a time range
`GET`	`/:solar_inverter_uuid/energy/production/latest`	Latest production state
`GET`	`/:solar_inverter_uuid/interval/production`	Production interval aggregation
`GET`	`/:solar_inverter_uuid/production-forecast`	Production forecast

Schedules

Method	Path	Purpose
`POST`	`/:solar_inverter_uuid/schedules`	Create curtailment schedule
`GET`	`/:solar_inverter_uuid/schedules`	List schedules
`GET`	`/:solar_inverter_uuid/schedules/:schedule_uuid`	Get one schedule
`DELETE`	`/:solar_inverter_uuid/schedules/:schedule_uuid`	Delete schedule
`GET`	`/:solar_inverter_uuid/flex/schedules`	Read flex-derived schedule intervals
`GET`	`/:solar_inverter_uuid/flex/schedules/:schedule_uuid`	Get one flex schedule interval

Schedule payload rules are documented under Schedules.

Payload concepts

Typical inverter object includes:

Identity (identifier)
Info: brand, model, isSteerable, liveDataSupported, curtailment options
lastProductionState: isProducing, productionRate, totalLifetimeProduction, time
disconnectedAt: null when still enrolled; timestamp when unlinked
Created / updated timestamps

Interpreting list results

The list includes disconnected inverters so historical production and schedules remain resolvable.

Field / signal	Meaning
Present in list	Registry record exists
`disconnectedAt = null`	Still enrolled
`lastProductionState`	Last known production snapshot (may be stale or zero)
`info.isSteerable`	Capability to receive control, not proof of live connectivity

See connections for the enrolment vs status distinction.

Guidance

Use latest production for operational snapshots; use interval/energy routes for analytics.
Do not treat “listed” as “currently generating.”
Gate schedule writes behind operator controls; they affect customer assets.
Confirm steer permission separately from read permission in your client roles.