GET /v1/reports/hourly-time-series
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
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.
Filter: Liefertag >= diesem Wert
dateFilter: Liefertag <= diesem Wert
dateHö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/hourly-time-series?customer_id=cust_b7e4a2c9&delivery_date_from=2026-03-01&delivery_date_to=2026-03-31&limit=10&after=gc_a1b2c3d4"{
"customer_id": "cust_b7e4a2c9",
"rows": [
{
"delivery_date": "2026-03-18",
"hour": 14,
"quantity_mwh": 29.5,
"designation": "covered_go_backed",
"designation_reason": null,
"shares": [
{
"asset": {
"mastr_number": "SEE941280003651",
"name": "WEA Nord 1"
},
"quantity_mwh": 16,
"coverage_source": "physical_delivery",
"attributes": {
"technology_code": "T020001",
"technology": "Wind onshore",
"energy_carrier_code": "F01050100",
"location": "Windparkstraße 1, 25813 Husum, DE",
"coordinates": "54.4858, 9.0605",
"installed_capacity_mw": 18,
"commissioning_date": "2019-06-27",
"subsidy_status": "unsubsidised",
"emission_factor": 0
}
},
{
"asset": {
"mastr_number": "SEE905467231018",
"name": "PV Süd 2"
},
"quantity_mwh": 13.5,
"coverage_source": "physical_delivery",
"attributes": {
"technology_code": "T010100",
"technology": "Solar photovoltaic",
"energy_carrier_code": "F01010100",
"location": "Industriestraße 5, 84028 Landshut, DE",
"coordinates": "48.5371, 12.1520",
"installed_capacity_mw": 25,
"commissioning_date": "2021-04-30",
"subsidy_status": "unsubsidised",
"emission_factor": 0
}
}
]
}
],
"pagination": {
"limit": 10,
"has_more": true,
"next_cursor": "gc_k8m2p4q7"
}
}{
"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
}/cancellation-requests/{request_id} GET
Einen Entwertungsantrag abrufen, um seinen Status zu verfolgen. Mit Zugriff von OES auf das HKNR-Konto geht der Antrag von submitted auf completed über, sobald OES die HKN-Entwertung im Registerabgleich feststellt. Mit hochgeladenem Beleg durchläuft er under_review und endet auf completed oder rejected — abgelehnt, wenn der Beleg Anlage, Liefermonat und Menge nicht ausweist. Nach dem Abschluss tragen die GC im GCR den Status cancelled, einen der beiden Endzustände. Erst mit beiden Entwertungen ist der Nachweis vollständig, und erst dann steht der Entwertungsnachweis bereit. Erforderlicher Scope: cancellations:write
/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