GET /v1/certificates
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
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 Liefertag filtern (lokaler Kalendertag, Europe/Berlin)
dateFilter: Liefertag >= diesem Wert
dateFilter: Liefertag <= diesem Wert
dateNach Lieferstunde 1–24 filtern (EPEX-Konvention — Stunde 14 umfasst 13:00–14:00 Uhr Ortszeit, Europe/Berlin)
1 <= value <= 24Nach der MaStR-Nummer der Erzeugungsanlage filtern
Nach dem Status des GC filtern
"issued" | "cancelled" | "expired"Nach dem Ort des zugehörigen HKN filtern
"oes_trading_account" | "buyer_account" | "cancelled"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/certificates?customer_id=cust_b7e4a2c9&delivery_date=2026-03-18&delivery_date_from=2026-03-01&delivery_date_to=2026-03-31&hour=14&mastr_number=SEE941280003651&status=issued&go_location=oes_trading_account&limit=10&after=gc_a1b2c3d4"{
"certificates": [
{
"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"
}
],
"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
}/customers GET
Die Teilnehmer auflisten, deren GC das angemeldete GCR-Konto führt: beim eigenen GCR-Konto eines Teilnehmers ihn selbst, beim GCR-Konto eines Dienstleisters jeden Teilnehmer, der sein Konto damit verknüpft hat. Hier beginnt jede Anbindung: Alle weiteren Aufrufe tragen eine customer_id, und die Sichten sind streng je Teilnehmer getrennt; es gibt keine Sicht, die den Bestand zweier Teilnehmer zusammenfasst. Inhaber der GC bleibt immer der Teilnehmer. Erforderlicher Scope: certificates:read
/certificates/{certificate_id} GET
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