GET /v1/customers
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
Freischaltung erforderlich
In: header
Query Parameters
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/customers?limit=10&after=gc_a1b2c3d4"{
"customers": [
{
"id": "cust_b7e4a2c9",
"name": "Käufer A",
"linked_at": "2026-01-12T08:00:00Z"
}
],
"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/rate_limited",
"title": "Ratenbegrenzung erreicht",
"status": 429
}Übersicht
API für den programmatischen Zugriff auf das GCR Portal: Teilnehmer, Bestand, Entwertung und die drei Reports des Nachweises
/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