GET /v1/reports/cancellation-proof
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
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 dem Entwertungsantrag filtern, aus dem die Einträge stammen
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/cancellation-proof?customer_id=cust_b7e4a2c9&production_month=2026-03&cancellation_request_id=creq_2e9b4f7a&limit=10&after=gc_a1b2c3d4"{
"customer_id": "cust_b7e4a2c9",
"entries": [
{
"cancellation_request_id": "creq_2e9b4f7a",
"production_month": "2026-03",
"asset": {
"mastr_number": "SEE941280003651",
"name": "WEA Nord 1"
},
"quantity_mwh": 90,
"go_cancelled_at": "2026-06-03T10:12:00Z",
"gc_cancelled_at": "2026-06-03T11:20:00Z"
}
],
"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/go-monthly-quantities GET
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
Übersicht
API für Bilanzkreisverantwortliche zur Einsicht in Verträge, Transaktionen und Nominierungen und zur Verwaltung der Kunden