GET /v1/cancellation-requests/{request_id}
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
Freischaltung erforderlich
In: header
Path Parameters
Kennung des Entwertungsantrags
Response Body
curl -X GET "https://api.otark.energy/v1/cancellation-requests/creq_2e9b4f7a"{
"id": "creq_2e9b4f7a",
"customer_id": "cust_b7e4a2c9",
"certificate_ids": [
"gc_5d8f3a1c",
"gc_8a2c7e4b"
],
"status": "completed",
"evidence_route": "service_provider_role",
"rejected_reason": null,
"requested_at": "2026-06-02T09:15:00Z",
"completed_at": "2026-06-03T11:20:00Z"
}{
"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 POST
Den Antrag stellen, die ausgewählten GC zu entwerten — den Antrag, nicht den Vollzug. Die Reihenfolge steht fest und wird durch die API nicht verändert: zuerst der HKN im HKNR, dann das GC im GCR; OES entwertet kein GC, bevor die Entwertung der zugehörigen HKN festgestellt ist. Wie es weitergeht, hängt davon ab, ob OES Zugriff auf das benannte HKNR-Konto hat, über die Dienstleisterrolle oder einen eigenen Benutzer mit Lesezugriff. Mit Zugriff bleibt evidence weg: OES stellt die HKN-Entwertung im Registerabgleich selbst fest, automatisch und ohne Entgelt. Ohne Zugriff ist evidence Pflicht, die Entwertungsbestätigung des HKNR (Kontoauszug oder Entwertungsbeleg) mit Anlage, Liefermonat und Menge; OES prüft sie manuell, und es kann ein Entgelt nach dem Preis- und Leistungsverzeichnis anfallen. Einen Beleg, der sich nicht zuordnen lässt, lehnt OES mit Begründung ab; die GC bleiben ausgestellt. Eine Pflicht zur Entwertung besteht nicht, und deshalb auch keine Frist. Den Fortgang verfolgen Sie über GET /v1/cancellation-requests/{request_id}; der Entwertungsnachweis steht erst nach dem Abschluss bereit. Erforderlicher Scope: cancellations:write
/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