Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nomos.energy/llms.txt

Use this file to discover all available pages before exploring further.

Nomos is a full-stack energy platform. We run the contracts, the smart-meter data flows, the procurement, the billing, and the regulatory reporting that go into a German electricity product, and we expose all of it as a single REST API. That means you can build something as small as a price widget on top of a customer’s existing subscription, or as large as your own white-labeled energy brand, without ever talking to a grid operator yourself.

​
What you can build

A headless energy brand

Run your own checkout, customer portal, and onboarding. Nomos handles the contracts, supplier switching, and billing in the background.

A HEMS integration

Pull a specific customer’s real-time and forecasted prices and shift their flexible loads into the cheapest 15-minute intervals.

A dynamic price display

Show today’s and tomorrow’s 15-minute prices in your app, EV charger, or heat-pump controller.

Event-driven workflows

React the moment a subscription is created, confirmed, activated, or ended: no polling, no scheduled jobs.

​
Get going

Quickstart

Make your first authenticated request in under 5 minutes.

Authentication

OAuth 2.0: Client Credentials for backends, Authorization Code for third-party apps.

API Reference

Every endpoint, request shape, and response schema, with copyable examples.

Webhooks

Receive signed events when things change in your account.

​
Core resources

Most integrations end up touching this same handful of objects. Each one links to its API reference.

Plans

Tariffs you offer to customers: pricing, fees, and supported metering resolutions.

Leads

Pre-checkout signups and quote requests captured from your funnel.

Customers

The end users on a contract: billing address, contact details, type.

Subscriptions

A customer on a plan at a specific delivery point. The center of gravity of the API.

Suppliers

The previous-supplier directory used during onboarding to cancel old contracts.

Prices

Real-time and forecasted prices per subscription, in 15-min or 60-min intervals.

Invoices

Monthly and final billing documents for a subscription.

Meter readings

Submitted and retrieved consumption readings for a subscription.

Meter orders

Order a smart meter (mME or iMS) for a customer’s delivery point.

​
Need a hand?

Email support@nomos.energy and include the requestId from any error response. For partnership and demo requests, book a demo.