GET /v1/reports/go-monthly-quantities
Die HKN-Monatsmengen abrufen: je Anlage und Liefermonat die GC-Menge des Teilnehmers und die auf sein benanntes HKNR-Konto übertragenen HKN, mit dem Stand der Übertragung. Den Restsaldo, der im Kalenderjahr in den Folgemonat rollt, liefert die Reporting API. Hat OES im Dezember-Clearing statt des Barausgleichs einen HKN aus einer anderen Anlage geliefert, erscheint er als eigene Zeile (fractional_balancing) mit Menge, Erzeugungsmonat und Herkunftsanlage. Der Report geht immer an den Teilnehmer, nie an den Inhaber des benannten Kontos. Dieser Endpunkt ist die API-Fassung des Reports; denselben Inhalt gibt es im GCR Portal als CSV und PDF. Erforderlicher Scope: reports:read
Freischaltung erforderlich
In: header
Query Parameters
Der Teilnehmer, dessen Sicht abgefragt wird. Die Sichten sind streng je Teilnehmer getrennt; es gibt keine Sicht, die den Bestand zweier Teilnehmer zusammenfasst.
Nach Erzeugungsmonat (Liefermonat) filtern, Format YYYY-MM
Nach der MaStR-Nummer der Erzeugungsanlage filtern
Höchstzahl der Einträge pro Seite
101 <= value <= 100Cursor für die nächste Seite — den Wert next_cursor aus der vorherigen Antwort übergeben
Response Body
curl -X GET "https://api.otark.energy/v1/reports/go-monthly-quantities?customer_id=cust_b7e4a2c9&production_month=2026-03&mastr_number=SEE941280003651&limit=10&after=gc_a1b2c3d4"{
"customer_id": "cust_b7e4a2c9",
"rows": [
{
"position_type": "asset_position",
"production_month": "2026-03",
"asset": {
"mastr_number": "SEE941280003651",
"name": "WEA Nord 1"
},
"gc_quantity_mwh": 90.4,
"go_quantity_mwh": 90
},
{
"position_type": "asset_position",
"production_month": "2026-03",
"asset": {
"mastr_number": "SEE905467231018",
"name": "PV Süd 2"
},
"gc_quantity_mwh": 30,
"go_quantity_mwh": 30
}
],
"pagination": {
"limit": 10,
"has_more": false,
"next_cursor": null
}
}{
"type": "https://gcr.otark.energy/errors/validation",
"title": "Validierung fehlgeschlagen",
"status": 400,
"instance": "/v1/cancellation-requests",
"errors": [
{
"field": "evidence",
"code": "required",
"message": "Evidence is required because OES has no access to the named register account"
}
]
}{
"type": "https://gcr.otark.energy/errors/invalid_api_key",
"title": "Ungültiger API-Schlüssel",
"status": 401
}{
"type": "https://gcr.otark.energy/errors/insufficient_scopes",
"title": "Unzureichende Scopes des API-Schlüssels",
"status": 403,
"detail": "Missing scope: cancellations:write. Please create a new API key with the required scopes."
}{
"type": "https://gcr.otark.energy/errors/certificate_not_found",
"title": "GC nicht gefunden",
"status": 404,
"instance": "/v1/certificates/gc_5d8f3a1c"
}{
"type": "https://gcr.otark.energy/errors/rate_limited",
"title": "Ratenbegrenzung erreicht",
"status": 429
}/reports/hourly-time-series GET
Die Stunden-Zeitreihe abrufen: die HC des Teilnehmers je Liefertag und Stunde, mit dem Merkmalsnachweis je Erzeugungsanteil, final mit dem Monatsabschluss. Die Stundenwerte sind laufend verfügbar, sobald sie entstehen. Nach außen gibt es nur die Stunde; darunter führt das GCR viertelstündlich, weist die Viertelstunde aber nicht aus. Jede Stunde trägt ihre Ausweisung, in jedem Format dieselbe, vom Regelfall gedeckt bis zu nicht grün gedeckt samt Ursache; in Green SPOT steht die Deckungsquelle je Anteil dabei. Der Report geht immer an den Teilnehmer, nie an den Inhaber des benannten Kontos. Dieser Endpunkt ist die API-Fassung des Reports; denselben Inhalt gibt es im GCR Portal als CSV und PDF. Erforderlicher Scope: reports:read
/reports/cancellation-proof GET
Den Entwertungsnachweis abrufen, die Bestätigung von OES, dass GC und HKN entwertet sind. Es gibt ihn erst nach beiden Entwertungen: Einträge entstehen, sobald ein Entwertungsantrag abgeschlossen ist; solange nichts entwertet ist, bleibt die Liste leer. Der Nachweis geht immer an den Teilnehmer, nie an den Inhaber des benannten Kontos. Dieser Endpunkt ist die API-Fassung des Reports; denselben Inhalt gibt es im GCR Portal als CSV und PDF. Über die drei Reports hinaus liefert das Register nichts — insbesondere keine Bestandsbestätigung zu einem frei gewählten Stichtag. Erforderlicher Scope: reports:read