> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumenaza.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Lumenaza Documentation

> Welcome to the Lumenaza developer documentation. Manage energy consumers, producers, contracts, billing, and community data through the Lumenaza API.

Lumenaza provides a REST API that lets you register and manage consumers and renewable energy producers, handle contract lifecycles, process billing charges and credits, retrieve metering data, and access real-time community energy statistics — all through a single, unified interface.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Make your first API call in minutes. Set up authentication and create your first consumer.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Learn how to obtain an OAuth 2.0 access token and authorize your API requests.
  </Card>

  <Card title="Core Concepts" icon="book-open" href="/concepts/overview">
    Understand consumers, producers, contracts, products, and tariffs in Lumenaza.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Detailed endpoint documentation with request and response schemas.
  </Card>
</CardGroup>

## What You Can Build

The Lumenaza API is designed for energy companies who need to automate customer onboarding and energy management workflows.

<CardGroup cols={3}>
  <Card title="Consumer Management" icon="users" href="/guides/register-consumer">
    Register electricity consumers and manage their supply contracts end-to-end.
  </Card>

  <Card title="Producer Onboarding" icon="solar-panel" href="/guides/register-producer">
    Onboard renewable energy plant operators with full plant data and feed-in tracking.
  </Card>

  <Card title="Charges & Credits" icon="coins" href="/guides/charges-and-credits">
    Apply  payments and custom charges to customer invoices.
  </Card>

  <Card title="Community Analytics" icon="chart-line" href="/data/community-data">
    Track aggregated feed-in, supply, self-sufficiency, and CO₂ savings across your community.
  </Card>

  <Card title="Energy Pricing" icon="bolt" href="/data/prices">
    Query EPEX spot market prices, local utility rates, and offer calculator results.
  </Card>

  <Card title="Metering Data" icon="gauge" href="/data/metering-data">
    Access meter readings and supply or feed-in time-series data for any contract.
  </Card>
</CardGroup>

## Get Started in 4 Steps

<Steps>
  <Step title="Obtain credentials">
    Contact Lumenaza to receive your OAuth 2.0 client credentials (`client_id` and `client_secret`).
  </Step>

  <Step title="Get an access token">
    Exchange your credentials for a bearer token at the token endpoint. Tokens expire and must be refreshed.
  </Step>

  <Step title="Make your first call">
    Use the token to call `GET /v3/consumers/` and verify your integration is working.
  </Step>

  <Step title="Explore the guides">
    Follow the [Register a Consumer](/guides/register-consumer) or [Register a Producer](/guides/register-producer) guide to complete your first full workflow.
  </Step>
</Steps>

<Note>
  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.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.