Skip to main content
Lumenaza is a cloud-based energy SaaS platform built for innovative companies operating in the renewable energy market. Through the Lumenaza API, you can fully manage the lifecycle of both electricity consumers and producers — from quoting, initial registration and onboarding through handling of availabilities, metering data, and billing. Whether you are onboarding a household consumer to a dynamic tariff or a solar producer to your direct marketing offering, every operation is available programmatically via a single, consistent REST API surface.

​
Environments

Lumenaza provides two environments. Use the test environment during development — it is fully isolated from production data. All API endpoints are served under the /v3/ path prefix, for example https://api.lumenaza.de/v3/consumers/.

​
Authentication

The API uses the OAuth 2.0 client credentials flow. You exchange your client_id and client_secret for a short-lived bearer token, then include that token in the Authorization header of every subsequent request. Contact Lumenaza to obtain credentials for your organisation.
All requests must be made over HTTPS. Plain HTTP connections are rejected. Always store your client_secret securely and never expose it in client-side code or public repositories.

​
Explore the Documentation

Quickstart

Get your first API call running in minutes — from token request to registering your first consumer.

Authentication

Learn how the OAuth 2.0 client credentials flow works and how to manage token expiry in your integration.

Concepts Overview

Understand the core domain models — consumers, producers, contracts, metering points, and energy communities.

API Reference

Browse every endpoint with full request/response schemas, example payloads, and error code definitions.