Predictions
Predictions endpoints of the DynVolt Open API.
AI forecasts: per-plant production (P10/P50/P90), forecast-versus-actual, price forecasts for the assigned market, and model-accuracy metrics.
GET /v1/sites/{site_id}/predictions/forecast
Production forecast, all plants (?date&refresh).
Scope: predictions:read · Module: ai_predictions
| Query parameter | Type | Required | Description |
|---|---|---|---|
date | string | no | Forecast day, YYYY-MM-DD (UTC). Defaults to today. |
refresh | boolean | no | Force a fresh model run instead of the cached vintage. |
curl "https://api.owner.dynvolt.com/v1/sites/pv-ljubas/predictions/forecast" \
-H "Authorization: Bearer $DYNVOLT_API_KEY"GET /v1/sites/{site_id}/predictions/forecast/logger/{logger_id}
Production forecast for one plant (?date).
Scope: predictions:read · Module: ai_predictions
| Query parameter | Type | Required | Description |
|---|---|---|---|
date | string | no | Forecast day, YYYY-MM-DD (UTC). Defaults to today. |
curl "https://api.owner.dynvolt.com/v1/sites/pv-ljubas/predictions/forecast/logger/4" \
-H "Authorization: Bearer $DYNVOLT_API_KEY"GET /v1/sites/{site_id}/predictions/production
Forecast vs actual production (?start&end&logger_id).
Scope: predictions:read · Module: ai_predictions
| Query parameter | Type | Required | Description |
|---|---|---|---|
start | string | no | Window start — RFC3339 UTC, e.g. 2026-08-01T00:00:00Z. Naive (offset-less) timestamps are rejected. |
end | string | no | Window end — RFC3339 UTC. Must be after start. |
logger_id | integer | no | Restrict to a single logger (plant). Omit for all plants. |
curl "https://api.owner.dynvolt.com/v1/sites/pv-ljubas/predictions/production" \
-H "Authorization: Bearer $DYNVOLT_API_KEY"GET /v1/sites/{site_id}/predictions/prices
Price forecast for the assigned market (?start&end).
Scope: predictions:read · Module: ai_predictions
| Query parameter | Type | Required | Description |
|---|---|---|---|
start | string | no | Window start — RFC3339 UTC, e.g. 2026-08-01T00:00:00Z. Naive (offset-less) timestamps are rejected. |
end | string | no | Window end — RFC3339 UTC. Must be after start. |
curl "https://api.owner.dynvolt.com/v1/sites/pv-ljubas/predictions/prices" \
-H "Authorization: Bearer $DYNVOLT_API_KEY"GET /v1/sites/{site_id}/predictions/model-status
Model accuracy metrics.
Scope: predictions:read · Module: ai_predictions
curl "https://api.owner.dynvolt.com/v1/sites/pv-ljubas/predictions/model-status" \
-H "Authorization: Bearer $DYNVOLT_API_KEY"