GET /v1/certificates/{certificate_id}
Ein einzelnes HC samt der Registerangaben abrufen, die das GCR dazu führt: Tupel, Anlage, Menge, Merkmale, Status, Ort des HKN, Deckungsquelle, HKN-Übertragung und Entwertung. Die Detailansicht nennt nie die Identitäten früherer Inhaber — der Handel ist anonym, und das Register hebt das nicht auf; die vollständige Kette kennt allein OES. Preise und Transaktionen enthält sie ebenfalls nicht. Erforderlicher Scope: certificates:read
Freischaltung erforderlich
curl -X GET "https://api.otark.energy/v1/certificates/gc_5d8f3a1c"{
"id": "gc_5d8f3a1c",
"customer_id": "cust_b7e4a2c9",
"delivery_date": "2026-03-18",
"hour": 14,
"hour_suffix": null,
"interval_start": "2026-03-18T12:00:00Z",
"interval_end": "2026-03-18T13:00:00Z",
"asset": {
"mastr_number": "SEE941280003651",
"name": "WEA Nord 1"
},
"quantity_mwh": 16,
"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
},
"status": "issued",
"go_location": "buyer_account",
"coverage_source": "physical_delivery",
"go_transfer": {
"transferred_at": "2026-05-11T08:00:00Z",
"quantity_mwh": 90
},
"go_cancelled_at": null,
"cancelled_at": null,
"issued_at": "2026-04-21T05:45: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
}/certificates GET
Die HC des angegebenen Teilnehmers auflisten, je Liefertag und Stunde. Ein HC ist die Zusammenfassung der vier QHC derselben Stunde; darunter führt das GCR viertelstündlich, weist die Viertelstunde aber nicht aus. Filterbar nach Liefertag, Stunde, Erzeugungsanlage, Status und Ort des HKN. Erforderlicher Scope: certificates:read
/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