Leneda API Client

A Python client for interacting with the Leneda energy data platform API.

PLEASE NOTE: As long as the library is in a version below 1.0.0, breaking changes may also be introduced between minor version bumps.

Overview

This client provides a simple interface to the Leneda API, which allows users to:

• Retrieve metering data for specific time ranges
• Get aggregated metering data (hourly, daily, weekly, monthly, or total)
• Create metering data access requests
• Use predefined OBIS code constants for easy reference

Installation

pip install leneda-client

Trying it out

$ export LENEDA_ENERGY_ID='LUXE-xx-yy-1234'
$ export LENEDA_API_KEY='YOUR-API-KEY'
$ python examples/basic_usage.py --metering-point LU0000012345678901234000000000000
Example 1: Getting hourly electricity consumption data for the last 7 days
Retrieved 514 consumption measurements
Unit: kW
Interval length: PT15M
Metering point: LU0000012345678901234000000000000
OBIS code: ObisCode.ELEC_CONSUMPTION_ACTIVE

First 3 measurements:
Time: 2025-04-18T13:30:00+00:00, Value: 0.048 kW, Type: Actual, Version: 2, Calculated: False
Time: 2025-04-18T13:45:00+00:00, Value: 0.08 kW, Type: Actual, Version: 2, Calculated: False
Time: 2025-04-18T14:00:00+00:00, Value: 0.08 kW, Type: Actual, Version: 2, Calculated: False

Example 2: Getting monthly aggregated electricity consumption for 2025
Retrieved 4 monthly aggregations
Unit: kWh

Monthly consumption:
Period: 2024-12 to 2025-01, Value: 30.858 kWh, Calculated: False
Period: 2025-01 to 2025-02, Value: 148.985 kWh, Calculated: False
Period: 2025-02 to 2025-03, Value: 44.619 kWh, Calculated: False
Period: 2025-03 to 2025-04, Value: 29.662 kWh, Calculated: False

Listing metering points for a sharing group

You can retrieve the metering points belonging to a sharing group for a given date.

The Leneda API expects the sharing group contract number, for example CR00007479.

If no date is provided, the client uses today's date.

import asyncio
import os
from datetime import date

from leneda import LenedaClient


async def main() -> None:
    client = LenedaClient(
        api_key=os.environ["LENEDA_API_KEY"],
        energy_id=os.environ["LENEDA_ENERGY_ID"],
    )

    groups = await client.list_sharing_groups()

    for group in groups:
        print(f"{group.contract_number} | {group.type}")

        metering_points = await client.get_sharing_group_metering_points(
            group.contract_number,
            on_date=date.today(),
        )

        for metering_point in metering_points:
            print(f"  {metering_point}")


asyncio.run(main())