Metering API
GET /v1/metering-points
Die Messstellen des angemeldeten Teilnehmers auflisten. Messstellen entstehen im Anlagen-Onboarding oder beim Einrichten eines Lastgangs — die API legt sie nicht an. Erforderlicher Scope: metering:read
Freischaltung erforderlich
Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
X-Api-Key<token>
In: header
Query Parameters
asset_id?string
Nach zugeordneter Anlage filtern
direction?string
Nach konfigurierter Richtung filtern
Value in
"production" | "consumption" | "both"status?string
Nach Status der Messstelle filtern
Value in
"pending" | "active"limit?integer
Höchstzahl der Einträge pro Seite
Default
10Range
1 <= value <= 100after?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.com/v1/metering-points?asset_id=ast_7p2q9r4s&direction=production&status=pending&limit=10&after=mp_a1b2c3d4"{
"metering_points": [
{
"id": "mp_e4f8a2c6",
"melo_id": "DE0009900000000000000000000WEAN01",
"malo_id": "41770354291",
"asset_id": "ast_7p2q9r4s",
"asset_name": "WEA Nord 1",
"direction": "production",
"interval_minutes": 15,
"status": "active",
"created_at": "2026-01-12T09:00:00Z"
}
],
"pagination": {
"limit": 10,
"has_more": false,
"next_cursor": null
}
}{
"type": "https://api.otark.com/errors/validation",
"title": "Validierung fehlgeschlagen",
"status": 400,
"instance": "/v1/metering-points/mp_e4f8a2c6/readings",
"errors": [
{
"field": "readings.2.interval_start",
"code": "not_quarter_hour",
"message": "interval_start must be on a quarter-hour boundary (UTC), received '2026-03-18T12:07:00Z'"
}
]
}{
"type": "https://api.otark.com/errors/invalid_api_key",
"title": "Ungültiger API-Schlüssel",
"status": 401
}{
"type": "https://api.otark.com/errors/insufficient_scopes",
"title": "Unzureichende Scopes des API-Schlüssels",
"status": 403,
"detail": "Missing scope: metering:write. Please create a new API key with the required scopes."
}