GCR Connect API

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

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
X-Api-Key<token>

In: header

Query Parameters

customer_idstring

Der Teilnehmer, dessen Sicht abgefragt wird. Die Sichten sind streng je Teilnehmer getrennt; es gibt keine Sicht, die den Bestand zweier Teilnehmer zusammenfasst.

delivery_date?string

Nach Liefertag filtern (lokaler Kalendertag, Europe/Berlin)

Formatdate
delivery_date_from?string

Filter: Liefertag >= diesem Wert

Formatdate
delivery_date_to?string

Filter: Liefertag <= diesem Wert

Formatdate
hour?integer

Nach Lieferstunde 1–24 filtern (EPEX-Konvention — Stunde 14 umfasst 13:00–14:00 Uhr Ortszeit, Europe/Berlin)

Range1 <= value <= 24
mastr_number?string

Nach der MaStR-Nummer der Erzeugungsanlage filtern

status?string

Nach dem Status des GC filtern

Value in"issued" | "cancelled" | "expired"
go_location?string

Nach dem Ort des zugehörigen HKN filtern

Value in"oes_trading_account" | "buyer_account" | "cancelled"
limit?integer

Höchstzahl der Einträge pro Seite

Default10
Range1 <= value <= 100
after?string

Cursor 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
}