GCR Connect API

GET /v1/reports/hourly-time-series

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
GET
/v1/reports/hourly-time-series
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_from?string

Filter: Liefertag >= diesem Wert

Formatdate
delivery_date_to?string

Filter: Liefertag <= diesem Wert

Formatdate
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/reports/hourly-time-series?customer_id=cust_b7e4a2c9&delivery_date_from=2026-03-01&delivery_date_to=2026-03-31&limit=10&after=gc_a1b2c3d4"

{
  "customer_id": "cust_b7e4a2c9",
  "rows": [
    {
      "delivery_date": "2026-03-18",
      "hour": 14,
      "quantity_mwh": 29.5,
      "designation": "covered_go_backed",
      "designation_reason": null,
      "shares": [
        {
          "asset": {
            "mastr_number": "SEE941280003651",
            "name": "WEA Nord 1"
          },
          "quantity_mwh": 16,
          "coverage_source": "physical_delivery",
          "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
          }
        },
        {
          "asset": {
            "mastr_number": "SEE905467231018",
            "name": "PV Süd 2"
          },
          "quantity_mwh": 13.5,
          "coverage_source": "physical_delivery",
          "attributes": {
            "technology_code": "T010100",
            "technology": "Solar photovoltaic",
            "energy_carrier_code": "F01010100",
            "location": "Industriestraße 5, 84028 Landshut, DE",
            "coordinates": "48.5371, 12.1520",
            "installed_capacity_mw": 25,
            "commissioning_date": "2021-04-30",
            "subsidy_status": "unsubsidised",
            "emission_factor": 0
          }
        }
      ]
    }
  ],
  "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
}