Quick Start
Make your first API call in minutes. Set up authentication and create your first consumer.
Authentication
Learn how to obtain an OAuth 2.0 access token and authorize your API requests.
Core Concepts
Understand consumers, producers, contracts, products, and tariffs in Lumenaza.
API Reference
Detailed endpoint documentation with request and response schemas.
What You Can Build
The Lumenaza API is designed for energy companies who need to automate customer onboarding and energy management workflows.Consumer Management
Register electricity consumers and manage their supply contracts end-to-end.
Producer Onboarding
Onboard renewable energy plant operators with full plant data and feed-in tracking.
Charges & Credits
Apply payments and custom charges to customer invoices.
Community Analytics
Track aggregated feed-in, supply, self-sufficiency, and CO₂ savings across your community.
Energy Pricing
Query EPEX spot market prices, local utility rates, and offer calculator results.
Metering Data
Access meter readings and supply or feed-in time-series data for any contract.
Get Started in 4 Steps
1
Obtain credentials
Contact Lumenaza to receive your OAuth 2.0 client credentials (
client_id and client_secret).2
Get an access token
Exchange your credentials for a bearer token at the token endpoint. Tokens expire and must be refreshed.
3
Make your first call
Use the token to call
GET /v3/consumers/ and verify your integration is working.4
Explore the guides
Follow the Register a Consumer or Register a Producer guide to complete your first full workflow.
Both a production server (
https://api.lumenaza.de/) and a test server (https://api.test.lumenaza.de/) are available. Use the test server during development.