Efficiency & diagnostics
Efficiency & diagnostics endpoints of the DynVolt Open API.
Performance diagnostics: specific-yield / capacity-factor rankings for loggers and inverters, string rankings by orientation group, the per-string health matrix, DC→AC loss analysis, and side-by-side string comparison.
GET /v1/sites/{site_id}/efficiency/loggers
Logger specific-yield / capacity-factor rankings (?start&end).
Scope: diagnostics:read · Module: basic_scada
| 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/efficiency/loggers" \
-H "Authorization: Bearer $DYNVOLT_API_KEY"GET /v1/sites/{site_id}/efficiency/inverters
Inverter rankings incl. efficiency (?start&end&logger_id).
Scope: diagnostics:read · Module: basic_scada
| 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/efficiency/inverters" \
-H "Authorization: Bearer $DYNVOLT_API_KEY"GET /v1/sites/{site_id}/efficiency/strings
String rankings by orientation group (?start&end&inverter_ids&orientation).
Scope: diagnostics:read · Module: basic_scada
| 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. |
inverter_ids | string | no | Comma-separated inverter IDs to include. |
orientation | string | no | Restrict to one orientation group (e.g. east, west, south). |
curl "https://api.owner.dynvolt.com/v1/sites/pv-ljubas/efficiency/strings" \
-H "Authorization: Bearer $DYNVOLT_API_KEY"GET /v1/sites/{site_id}/efficiency/health-matrix
Per-string health grid vs peers (?start&end).
Scope: diagnostics:read · Module: basic_scada
| 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/efficiency/health-matrix" \
-H "Authorization: Bearer $DYNVOLT_API_KEY"GET /v1/sites/{site_id}/efficiency/loss-analysis
DC→AC conversion loss per inverter (?start&end).
Scope: diagnostics:read · Module: basic_scada
| 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/efficiency/loss-analysis" \
-H "Authorization: Bearer $DYNVOLT_API_KEY"GET /v1/sites/{site_id}/strings/inverter/{inverter_id}/compare
All strings of an inverter side-by-side (?start&end).
Scope: diagnostics:read · Module: basic_scada
| 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/strings/inverter/12/compare" \
-H "Authorization: Bearer $DYNVOLT_API_KEY"