Skip to main content
The Lumenaza API is built around a clear hierarchy: a tenant (your organisation) manages end-customers — consumers and producers — each of whom holds one or more contracts for energy delivery or feed-in. Every contract is tied to a physical supply point identified by a Market Location (MaLo) in the German grid, and is priced by a product (tariff plan). Understanding how these entities relate to one another is the foundation for working with the API effectively. The sections below introduce each concept in detail. Use the cards to navigate to the topic you need.

Consumers & Producers

Learn about the two types of customers — electricity buyers and renewable energy plant operators — including prosumers who act as both.

Contracts

Understand the energy delivery agreement lifecycle, registration statuses, market locations, meters, and how to terminate or revoke a contract.

Products & Tariffs

Explore how pricing plans are attached to contracts, including validity periods, contract terms, product switches, and the offer calculator.

​
Data model at a glance

The diagram below shows how the core entities are related.
Every entity you create in Lumenaza can carry your own system’s identifier — saas_customer_id for customers and saas_contract_id for contracts — making it straightforward to reconcile Lumenaza records with your own database.