Skip to main content
GET
Scored forecast accuracy for an inverter, by hour and forecast tier

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

org_id
string<uuid>
required

The organization the inverter belongs to.

inverter_id
string<uuid>
required

The inverter whose scored accuracy to read.

Query Parameters

kind
enum<string>
default:pv

Which forecast to score: PV production or household consumption.

Available options:
pv,
hh
days
integer
default:7

Window length in days, ending now (1..15, default 7) — the same window the runs route draws.

Required range: 1 <= x <= 15

Response

200 - application/json

OK

One inverter's scored forecast accuracy over the window, per hour and tier.

What the daily accuracy job scored — InverterForecastAccuracyPoint, cleaned actuals against each tier's run — rather than the raw comparison the runs route invites. tiers names the tiers kind is scored on in display order: day-ahead (the D-1 morning run), midnight (the first run of the day), intraday (the run two hours ahead), and for household the rolling 7-day baseline it is measured against. Only completed local days are scored, so the newest hours of the window carry no entry yet.

now
string<date-time>
required

Server time when the window was resolved.

window_start
string<date-time>
required

First slot of the window the scores were read over.

kind
enum<string>
required

Which forecast the scores are about.

Available options:
pv,
hh
kwp_w
number | null
required

The inverter's resolved array capacity in watts, or null when unknown.

tiers
string[]
required

The tiers this kind is scored on, in display order.

hours
ForecastAccuracyHourOutput · object[]
required

Every hour in the window some tier scored, hour-ordered; an hour nothing scored is absent.