GCR Connect API

GET /v1/reports/go-monthly-quantities

Die HKN-Monatsmengen abrufen: je Anlage und Liefermonat die GC-Menge des Teilnehmers und die auf sein benanntes HKNR-Konto übertragenen HKN, mit dem Stand der Übertragung. Den Restsaldo, der im Kalenderjahr in den Folgemonat rollt, liefert die Reporting API. Hat OES im Dezember-Clearing statt des Barausgleichs einen HKN aus einer anderen Anlage geliefert, erscheint er als eigene Zeile (fractional_balancing) mit Menge, Erzeugungsmonat und Herkunftsanlage. 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/go-monthly-quantities
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.

production_month?string

Nach Erzeugungsmonat (Liefermonat) filtern, Format YYYY-MM

mastr_number?string

Nach der MaStR-Nummer der Erzeugungsanlage filtern

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/go-monthly-quantities?customer_id=cust_b7e4a2c9&production_month=2026-03&mastr_number=SEE941280003651&limit=10&after=gc_a1b2c3d4"

{
  "customer_id": "cust_b7e4a2c9",
  "rows": [
    {
      "position_type": "asset_position",
      "production_month": "2026-03",
      "asset": {
        "mastr_number": "SEE941280003651",
        "name": "WEA Nord 1"
      },
      "gc_quantity_mwh": 90.4,
      "go_quantity_mwh": 90
    },
    {
      "position_type": "asset_position",
      "production_month": "2026-03",
      "asset": {
        "mastr_number": "SEE905467231018",
        "name": "PV Süd 2"
      },
      "gc_quantity_mwh": 30,
      "go_quantity_mwh": 30
    }
  ],
  "pagination": {
    "limit": 10,
    "has_more": false,
    "next_cursor": null
  }
}

{
  "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
}