Zympler.

Read site telemetry

Find a location and get its energy flows for yesterday.

This guide finds your locations and reads the measured energy flows of one of them, per 15 minutes. It assumes you have an access token (see Your first request).

1. Find the location

List the organisations you have access to, then the locations of one of them:

curl

curl "https://api.zympler.com/v1beta/organisations" \
  -H "Authorization: Bearer $ZYMPLER_TOKEN"

curl "https://api.zympler.com/v1beta/organisations/$ORGANISATION_ID/locations" \
  -H "Authorization: Bearer $ZYMPLER_TOKEN"

Rust

let http = reqwest::Client::new();
let base = "https://api.zympler.com/v1beta";

let organisations: Vec<serde_json::Value> = http
    .get(format!("{base}/organisations"))
    .bearer_auth(&token)
    .send().await?.error_for_status()?
    .json().await?;
let organisation_id = organisations[0]["id"].as_str().unwrap();

let locations: Vec<serde_json::Value> = http
    .get(format!("{base}/organisations/{organisation_id}/locations"))
    .bearer_auth(&token)
    .send().await?.error_for_status()?
    .json().await?;
let location_id = locations[0]["id"].as_str().unwrap();

Python

base = "https://api.zympler.com/v1beta"
headers = {"Authorization": f"Bearer {token}"}

organisations = requests.get(f"{base}/organisations", headers=headers, timeout=30).json()
organisation_id = organisations[0]["id"]

locations = requests.get(
    f"{base}/organisations/{organisation_id}/locations", headers=headers, timeout=30
).json()
location_id = locations[0]["id"]

2. Get the measurements

Ask for yesterday, in 15-minute intervals. Times are in UTC.

curl

curl -G "https://api.zympler.com/v1beta/telemetry/locations/$LOCATION_ID" \
  -H "Authorization: Bearer $ZYMPLER_TOKEN" \
  --data-urlencode "start=2026-11-15T00:00:00Z" \
  --data-urlencode "end=2026-11-16T00:00:00Z" \
  --data-urlencode "resolution=15m"

Rust

let measurements: Vec<serde_json::Value> = http
    .get(format!("{base}/telemetry/locations/{location_id}"))
    .bearer_auth(&token)
    .query(&[
        ("start", "2026-11-15T00:00:00Z"),
        ("end", "2026-11-16T00:00:00Z"),
        ("resolution", "15m"),
    ])
    .send().await?.error_for_status()?
    .json().await?;

for m in &measurements {
    println!("{} grid import {} Wh", m["interval"]["start"], m["from_grid"]["energy"]);
}

Python

measurements = requests.get(
    f"{base}/telemetry/locations/{location_id}",
    headers=headers,
    params={
        "start": "2026-11-15T00:00:00Z",
        "end": "2026-11-16T00:00:00Z",
        "resolution": "15m",
    },
    timeout=30,
).json()

for m in measurements:
    print(m["interval"]["start"], "grid import", m.get("from_grid", {}).get("energy"), "Wh")

Each measurement covers one interval and contains energy (Wh) and power (W) per flow, like from_grid, to_battery or from_solar, plus a breakdown of where the energy went. Flows that don't apply to the site are left out. All fields are listed under Telemetry.

For totals over a period, use the summary endpoint (/telemetry/locations/{location_id}/summary) instead of adding up intervals yourself.

Search