---
id: electrickiwi-api
version: "0.10.1"
license: GPL-3.0-only
license_treatment: copyleft
maintenance: active
---

# electrickiwi-api — Async Python client for the Electric Kiwi API

License: copyleft · Maintenance: active · Downloads: 73.6K/mo

## What it is and what it does

electrickiwi-api is an async Python client for the Electric Kiwi energy provider API, built on aiohttp. It wraps Electric Kiwi's HTTP endpoints to let you query and manage your account data—active sessions, connection details, and related state—without managing tokens or sessions yourself (you provide the auth implementation). The package is minimal by design: it handles the API calls but leaves authentication, session management, and token lifecycle to you, assuming you'll use an existing library or framework for those concerns.

The package requires Python 3.13 or later and depends only on aiohttp. You implement the AbstractAuth interface to supply credentials, then pass it to ElectricKiwiApi and make async calls. After retrieving your session, you must call set_active_session() to store your customer number and connection ID on the client instance, which subsequent API calls then use automatically.

Use it for:

- Query your Electric Kiwi account status and active session details in an async Python application.
- Automate energy usage monitoring or billing checks by calling the Electric Kiwi API from a scheduled task.
- Build a dashboard or reporting tool that pulls real-time account data from Electric Kiwi.
- Integrate Electric Kiwi account management into a larger async application or service.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Async Python client for the Electric Kiwi API that provides a simple interface to query and manage Electric Kiwi energy account data using basic authentication.

Yes, if you are an Electric Kiwi customer building an async Python application and need direct API access. The package is actively maintained, has low install friction, and requires only aiohttp. However, the GPL-3.0-only license means any derivative work must also be GPL-3.0-only, and the low star count and small user base suggest limited real-world validation. Verify that the API coverage meets your needs before committing.

## Install

pip install electrickiwi-api
uv add electrickiwi-api
poetry add electrickiwi-api

## Installing electrickiwi-api

Before you install: Low install friction with a single async dependency (aiohttp). Actively maintained with recent releases; last commit 2026-08-04. Requires Python 3.13 or later.

License in practice: Licensed under GPL-3.0-only (copyleft). Any derivative work or distribution must also be released under GPL-3.0-only; proprietary use is not permitted.

Quickstart:

pip install electrickiwi-api

from electrickiwi_api import ElectricKiwiApi

api = ElectricKiwiApi(auth_impl)
await api.get_active_session()
await api.set_active_session()

Requires Python 3.13 or later. You must implement AbstractAuth to handle authentication before passing it to ElectricKiwiApi.

Verify before relying:

- Whether the package is suitable for production use given its low star count (1) and small download volume.
- Scope and completeness of the Electric Kiwi API coverage—which endpoints are supported.
- Whether session/token management responsibility on the caller is a practical constraint for typical use cases.

## Package facts

- License: GPL-3.0-only (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 73.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

electric kiwi api client, async energy api python, electric kiwi account management, aiohttp energy provider client, new zealand electricity api, async power utility client, async-http-client, energy-api, new-zealand

[View on SkillFed](https://skillfed.io/packages/electrickiwi-api) · [View on PyPI](https://pypi.org/project/electrickiwi-api/)