GCR Connect API

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
GET
/v1/certificates/{certificate_id}
X-Api-Key<token>

In: header

Path Parameters

certificate_idstring

Kennung des GC

Response Body

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