GET /v1/proofs/green-spot
Die Liefermonate auflisten, für die ein Green-SPOT-Nachweispaket vorliegt, samt ihrem Stand der Finalität. Ein Monat wird mit dem Monatsabschluss am 10. des übernächsten Monats final. Erforderlicher Scope: proofs:read
Freischaltung erforderlich
In: header
Query Parameters
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/proofs/green-spot?limit=10&after=pf_a1b2c3d4"{
"proof_packages": [
{
"month": "2026-07",
"final": false,
"cut_off_date": "2026-09-10"
},
{
"month": "2026-03",
"final": true,
"cut_off_date": "2026-05-10"
}
],
"pagination": {
"limit": 10,
"has_more": false,
"next_cursor": null
}
}{
"type": "https://api.otark.energy/errors/validation",
"title": "Validierung fehlgeschlagen",
"status": 400,
"instance": "/v1/proofs/green-spot/2026-3",
"errors": [
{
"field": "month",
"code": "invalid_format",
"message": "Invalid month format. Expected YYYY-MM, received '2026-3'"
}
]
}{
"type": "https://api.otark.energy/errors/invalid_api_key",
"title": "Ungültiger API-Schlüssel",
"status": 401
}{
"type": "https://api.otark.energy/errors/insufficient_scopes",
"title": "Unzureichende Scopes des API-Schlüssels",
"status": 403,
"detail": "Missing scope: proofs:read. Please create a new API key with the required scopes."
}/portfolios/{portfolio_id}/coverage-matching/{month} GET
Der Verbrauchsabgleich eines Portfolios für einen Liefermonat, stundenscharf. Je Stunde setzt der Report die HC und Ansprüche des Käufers gegen die Zielkurve: gedeckt, Unterdeckung und Überdeckung. Überdeckung wird nie in eine andere Stunde übertragen — eine Überschussstunde füllt keine Fehlstunde. Der Report ist produktneutral: HC aus 1-Click PPA zählen ebenso wie HC und Ansprüche aus Green SPOT, vor dem Monatsabschluss als Anspruch. Fehlt ein Viertelstundenwert der Zielkurve, rechnet OES die Stunde mit den vorliegenden Viertelstunden. Ohne Zielkurve weist der Report allein die Zertifikatskurve aus; target_curve_mwh, covered_mwh, under_coverage_mwh und over_coverage_mwh sind dann null. Die Stundenwerte sind laufend abrufbar, sobald sie entstehen. Erforderlicher Scope: proofs:read
/proofs/green-spot/{month} GET
Das Green-SPOT-Nachweispaket eines Liefermonats: die stundenscharfe HC-Zeitreihe mit der Ausweisung je Menge, der Deckungsquelle (coupled aus dem Bündel aus Strom und QHC, time_matched aus dem Granular Matching) und der Anlagenzuordnung je Stunde, dazu datierte Nachträge, als Backup gelieferte HKN und die entwertete HKN-Menge. Ab D+1 liefert der Report vorläufige Stundenwerte aus Messwerten und Verkäufermeldung, die Mengen als Anspruch mit ausstehender Zuteilung. Mit dem Monatsabschluss am 10. des übernächsten Monats teilt OES die HC und HKN je Stunde und Anlage zu, und der Nachweis des Monats ist final. Weil der HKN-Übertrag je Käufer über alle Anlagen abgerundet wird, können HKN und GC auf Bruchteilsebene aus verschiedenen Anlagen stammen. Was fehlt, weist der Nachweis aus und ersetzt es nicht; die Ursache steht je Menge dabei. Eine PDF-Fassung für Prüfer liefert die Anfrage mit Accept: application/pdf. Erforderlicher Scope: proofs:read