API Quick Start

With the energiedaten.at API you can retrieve measurement data from your meters programmatically. This guide shows you the fastest path to your first successful API call.

Step 1 — Create an API Key

Create a key under Profile → API Tokens or directly on the meter. For details, see Creating API Keys.

Make a note of the key — it is only shown once.

Step 2 — Copy the Meter ID

Open Meters → [select a meter] and copy the Zählpunkt number (33-character ID, starts with AT00...).

Step 3 — Make Your First API Call

Replace {YOUR_KEY} and {METER_ID} with your values:

curl https://energiedaten.at/api/v1/meters/{METER_ID}/measurements \
  -H "Authorization: Bearer {YOUR_KEY}" \
  -H "Accept: application/json"

A successful response looks like this:

{
  "data": [
    {
      "timestamp": "2025-03-16T08:00:00+01:00",
      "value_kwh": 0.285,
      "unit": "kWh",
      "quality": "measured"
    },
    {
      "timestamp": "2025-03-16T08:15:00+01:00",
      "value_kwh": 0.312,
      "unit": "kWh",
      "quality": "measured"
    }
  ],
  "meta": {
    "meter_id": "AT0010000000000000001000000000001",
    "from": "2025-03-16T08:00:00+01:00",
    "to": "2025-03-16T09:00:00+01:00",
    "count": 2
  }
}

Next Steps

The full API reference — all endpoints, parameters, and response formats — is available in the API documentation.

For automatic push delivery without polling, we recommend Webhooks or MQTT.