Reporting API

GET /v1/portfolios/{portfolio_id}

Ein einzelnes Portfolio über seine Kennung abrufen. Erforderlicher Scope: proofs: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/portfolios/{portfolio_id}
X-Api-Key<token>

In: header

Path Parameters

portfolio_idstring

Kennung des Portfolios

Response Body

curl -X GET "https://api.otark.energy/v1/portfolios/pf_8k3d92hs"
{
  "id": "pf_8k3d92hs",
  "name": "Werk Nord",
  "target_curve_source": "metering_data",
  "created_at": "2026-01-05T09:00:00Z"
}

{
  "type": "https://api.otark.energy/errors/invalid_api_key",
  "title": "Ungültiger API-Schlüssel",
  "status": 401
}

{
  "type": "https://api.otark.energy/errors/insufficient_scopes",
  "title": "Unzureichende Scopes des API-Schlüssels",
  "status": 403,
  "detail": "Missing scope: proofs:read. Please create a new API key with the required scopes."
}

{
  "type": "https://api.otark.energy/errors/portfolio_not_found",
  "title": "Portfolio nicht gefunden",
  "status": 404,
  "instance": "/v1/portfolios/pf_8k3d92hs"
}