# Metering API (https://docs.otark.com/de/developer/metering-api)

<Callout type="warn" title="Freischaltung erforderlich">
  Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den [Support](https://docs.otark.com/de/support).
</Callout>

Die Metering API ist der programmatische Weg, Lastgangdaten auf die Otark-Plattform zu bringen — als Ersatz für den manuellen CSV-Upload im Format der Seite [Lastgangdateien](https://docs.otark.com/de/developer/metering-files). Teilnehmer laden 15-Minuten-Messwerte zu ihren Messstellen hoch und fragen sie ab — zur Anzeige, zum Vergleich und zur Planung im eigenen Konto: **Verkäufer** die Erzeugungsdaten ihrer Anlagen, **Käufer** ihren Verbrauchs-Lastgang. Die Messstellen selbst entstehen im [Anlagen-Onboarding](https://docs.otark.com/de/onboarding/assets) — die API liest sie nur.

## Basis-URL

```
https://api.otark.com/v1
```

Alle Anfragen laufen über HTTPS. Antworten sind JSON; der CSV-Import nimmt `multipart/form-data` entgegen.

## Authentifizierung

Alle Anfragen tragen den Header `X-Api-Key`:

```bash
curl -X GET "https://api.otark.com/v1/metering-points" \
  -H "X-Api-Key: IHR_API_KEY"
```

Wie die Authentifizierung plattformweit funktioniert und wo die Schlüssel der übrigen APIs entstehen, steht unter [Authentifizierung](https://docs.otark.com/de/developer/authentication).

API-Schlüssel erstellen Sie in den Kontoeinstellungen auf `app.otark.com`. Jeder Schlüssel trägt Scopes: `metering:read` für Lesezugriffe, `metering:write` für das Hochladen.

## Konventionen

| Konvention      | Regel                                                                                                                                                                                                  |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Zeitstempel     | ISO 8601 in **UTC** (`2026-03-18T12:00:00Z`) — wie auf jedem Kanal, siehe [Granularität & Zeitstempel](https://docs.otark.com/de/granular-certificates/hourly-granularity)                                                   |
| Messwerte       | Dezimalzahl in **kWh**, je 15-Minuten-Intervall auf Viertelstundengrenze — gilt für die JSON-Endpunkte; die CSV-Datei trägt die Einheit je Zeile mit ([Lastgangdateien](https://docs.otark.com/de/developer/metering-files)) |
| Paginierung     | Listen nehmen `limit` (1–100, Vorgabe 10) und einen Cursor `after` entgegen; die Antwort führt `pagination` mit `has_more` und `next_cursor`                                                           |
| Fehler          | `application/problem+json` nach RFC 9457, mit Feldfehlern bei Validierungsfehlern                                                                                                                      |
| Ratenbegrenzung | **300 Anfragen je 60-Sekunden-Fenster**, plattformweit gleich; die Antwort führt `X-RateLimit-Limit`, `-Remaining` und `-Reset` mit, bei Überschreitung `429 Too Many Requests`                        |

## Ressourcen

| Ressource       | Zweck                                                                                                                       |
| --------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Messstellen** | Die Messstellen des Teilnehmers einsehen — angelegt im [Anlagen-Onboarding](https://docs.otark.com/de/onboarding/assets), über die API nur lesbar |
| **Messwerte**   | 15-Minuten-Werte je Messstelle als JSON hochladen und mit Zeitfenster abfragen                                              |
| **CSV-Import**  | Eine CSV-Datei im Format der Seite [Lastgangdateien](https://docs.otark.com/de/developer/metering-files) hochladen und den Importstatus abfragen  |

## Abgrenzung: keine Ausstellungsgrundlage

Was über die Metering API eingeht, sind **Daten des Teilnehmers**. Sie dienen der Anzeige, dem Vergleich und der Planung. Granulare Zertifikate entstehen ausschließlich aus den HKN des Erzeugungsmonats und den [finalen Messdaten des Messstellenbetreibers](https://docs.otark.com/de/granular-certificates/metering-data), die OES als Energieserviceanbieter auf Vollmacht direkt vom MSB erhält oder die der Verkäufer unter Zusatzvereinbarung unverändert an OES weiterleitet ([Messdatenwege](https://docs.otark.com/de/onboarding/metering-paths)). Diesen Weg ersetzt die Metering API nicht, und sie ist auch nicht der Kanal dieser Weiterleitung.

## Support

Bei Fragen oder für weitere Unterstützung erreichen Sie uns über den [Support](https://docs.otark.com/de/support).
