# Nomos ## Docs - [Authorize](https://docs.nomos.energy/api-reference/authentication/authorize.md): Create an authorized session - [Create a magic link (customer portal)](https://docs.nomos.energy/api-reference/authentication/create-a-magic-link-customer-portal.md): This endpoint can be used to create a customer portal magic link. The link (returned in the `link` property) allows your customer to directly access the customer portal. This is useful if you want to integrate the customer portal into your own application. Remember that it is your responsibility to… - [Create a token](https://docs.nomos.energy/api-reference/authentication/create-a-token.md): Retrieve a token - [Create a load forecast](https://docs.nomos.energy/api-reference/consumption/create-a-load-forecast.md): This endpoint is used to transmit a load forecast for a subscription. Values must be submitted by 9:00 a.m. local time on the previous day to be considered in the day-ahead auction, and at least 15 minutes before delivery to be included in continuous intraday trading. Data points must be strictly co… - [Create a meter reading](https://docs.nomos.energy/api-reference/consumption/create-a-meter-reading.md): Submit a customer-reported analog meter reading for the active meter of a subscription. - [List meter readings](https://docs.nomos.energy/api-reference/consumption/list-meter-readings.md): Retrieve all meter readings for a subscription with cursor pagination - [Retrieve consumption data](https://docs.nomos.energy/api-reference/consumption/retrieve-consumption-data.md): Retrieve the consumption data for a subscription. Results depend on the meter type. - [List customers](https://docs.nomos.energy/api-reference/customers/list-customers.md): Retrieve all customers with cursor pagination - [Retrieve a customer](https://docs.nomos.energy/api-reference/customers/retrieve-a-customer.md): Retrieve customer details by their id - [Retrieve an event](https://docs.nomos.energy/api-reference/events/retrieve-an-event.md): Retrieve event details by their id - [Create a grid fee reduction](https://docs.nomos.energy/api-reference/grid-fee-reductions/create-a-grid-fee-reduction.md): Create a new grid fee reduction for §14a EnWG modules. - [List grid fee reductions](https://docs.nomos.energy/api-reference/grid-fee-reductions/list-grid-fee-reductions.md): Retrieve all grid fee reductions for the organization. Customer users will only see their own. - [Retrieve a grid fee reduction](https://docs.nomos.energy/api-reference/grid-fee-reductions/retrieve-a-grid-fee-reduction.md): Retrieve a grid reduction details by its id - [List invoices](https://docs.nomos.energy/api-reference/invoices/list-invoices.md): Invoices summarise the amounts owed/payed for their monthly electricity bill. They are generated once per month and cover all line items including cost for electricity, grid fees, taxes and other charges. The related PDFs are available via the `/invoices/{id}/file` endpoint. - [Retrieve an invoice](https://docs.nomos.energy/api-reference/invoices/retrieve-an-invoice.md): Download the PDF of an invoice - [Retrieve an invoice PDF](https://docs.nomos.energy/api-reference/invoices/retrieve-an-invoice-pdf.md): Retrieve a PDF file of an invoice from the storage - [Create a lead](https://docs.nomos.energy/api-reference/leads/create-a-lead.md): This endpoint can be used to create a secure, pre-filled checkout link. The link (returned in the "link" property) contains all provided customer, address and meter data, allowing the prospect to finalize their signup with only providing the missing payment information, essentially enabling a 2-clic… - [List leads](https://docs.nomos.energy/api-reference/leads/list-leads.md): Retrieve all leads with cursor pagination - [Retrieve a lead](https://docs.nomos.energy/api-reference/leads/retrieve-a-lead.md): Retrieve lead details by its id - [List market partners](https://docs.nomos.energy/api-reference/market-partners/list-market-partners.md): This is a list of all German electricity retailers, which a customer can select as their previous supplier in the checkout process. It can be used to build a dropdown menu in an embedded checkout to select the previous supplier. - [Search market partners](https://docs.nomos.energy/api-reference/market-partners/search-market-partners.md): Deprecated: Use GET /suppliers with filter[name][contains]= instead. This is a list of all German electricity retailers, which a customer can select as their previous supplier in the checkout process. - [List plans](https://docs.nomos.energy/api-reference/plans/list-plans.md): Retrieve all plans with cursor pagination - [Retrieve a plan](https://docs.nomos.energy/api-reference/plans/retrieve-a-plan.md): Retrieve a plan details by its id - [Retrieve a quote](https://docs.nomos.energy/api-reference/plans/retrieve-a-quote.md): Retrieve a quote details by its id. All prices are inclusive of VAT. - [Retrieve a price time series](https://docs.nomos.energy/api-reference/prices/retrieve-a-price-time-series.md): Retrieve a price object for a given subscription, including the variable price time series to optimize your consumption against. All prices are inclusive of VAT. - [Create a smart meter order](https://docs.nomos.energy/api-reference/smart-meter-orders/create-a-smart-meter-order.md): Create a new meter order for a subscription. The subscription's plan must support a smart-meter product type. - [List smart meter orders](https://docs.nomos.energy/api-reference/smart-meter-orders/list-smart-meter-orders.md): Retrieve all meter orders for the organization - [Retrieve a smart meter order](https://docs.nomos.energy/api-reference/smart-meter-orders/retrieve-a-smart-meter-order.md): Retrieve a meter order by its ID - [Create a subscription](https://docs.nomos.energy/api-reference/subscriptions/create-a-subscription.md): Create a new subscription - [List subscriptions](https://docs.nomos.energy/api-reference/subscriptions/list-subscriptions.md): Retrieve all subscriptions - [Retrieve a subscription](https://docs.nomos.energy/api-reference/subscriptions/retrieve-a-subscription.md): Retrieve a subscription details by its id - [Authentication](https://docs.nomos.energy/api-references/authentication.md): Authenticating with the Nomos API using OAuth 2.0. - [Changelog](https://docs.nomos.energy/api-references/changelog.md): List of changes between the versions - [Errors](https://docs.nomos.energy/api-references/errors.md): Troubleshoot problems with this comprehensive breakdown of all error codes. - [Filtering](https://docs.nomos.energy/api-references/filtering.md): How we handle list filtering - [Introduction](https://docs.nomos.energy/api-references/introduction.md): How to read and work with the Nomos API reference. - [Pagination](https://docs.nomos.energy/api-references/pagination.md): How we handle list pagination - [Versioning](https://docs.nomos.energy/api-references/versioning.md): Understanding and managing API versions for your integration. - [Checkout](https://docs.nomos.energy/guides/checkout.md): Take a customer from quote to active subscription using your own UI, with Nomos handling the contract, supplier switch, and billing in the background. - [Customer Portal](https://docs.nomos.energy/guides/customer-portal.md): Surface a customer's contract, invoices, meter readings, and consumption inside your own app, with no Nomos UI involved. - [§14a EnWG Grid Fee Reductions](https://docs.nomos.energy/guides/grid-fee-reductions.md): Quote, order, and track Module 1, 2, and 3 grid fee reductions for customers with controllable consumption devices. - [HEMS integration](https://docs.nomos.energy/guides/hems-integration.md): Connect a Home Energy Management System to a Nomos subscription, pull that specific customer's prices, and shift their flexible loads into the cheapest intervals. - [Introduction](https://docs.nomos.energy/introduction.md): The Nomos API gives you everything you need to ship dynamic-electricity products: pricing, supplier switching, smart-meter data, billing, and webhooks, all under one roof. - [Quickstart](https://docs.nomos.energy/quickstart.md): Make your first authenticated request to the Nomos API in under five minutes. - [Event types](https://docs.nomos.energy/webhooks/event-types.md): The shape of every webhook payload and how topics are organized. - [subscription.activated](https://docs.nomos.energy/webhooks/events/subscription-activated.md): Received when a subscription becomes active and supply starts. - [subscription.confirmed](https://docs.nomos.energy/webhooks/events/subscription-confirmed.md): Received when the grid operator confirms the subscription's start date. - [subscription.created](https://docs.nomos.energy/webhooks/events/subscription-created.md): Received when a customer completes signup. - [subscription.ended](https://docs.nomos.energy/webhooks/events/subscription-ended.md): Received when a subscription's supply has ended. - [subscription.terminated](https://docs.nomos.energy/webhooks/events/subscription-terminated.md): Received when a subscription's end date is scheduled. - [Introduction](https://docs.nomos.energy/webhooks/introduction.md): Receive signed events from Nomos when subscriptions move through their lifecycle, then react to them reliably in your backend. - [Retries and replays](https://docs.nomos.energy/webhooks/retries-and-replays.md): How Nomos handles slow endpoints, duplicate deliveries, and out-of-order events. - [Verify Webhook Requests](https://docs.nomos.energy/webhooks/verify-requests.md): Use the signing secret to confirm a webhook really came from Nomos. ## OpenAPI Specs - [openapi.2025-12-01.chucky](https://api.nomos.energy/openapi.2025-12-01.chucky.json) - [openapi.2025-12-16.batman](https://api.nomos.energy/openapi.2025-12-16.batman.json) - [openapi.2026-01-29.edison](https://api.nomos.energy/openapi.2026-01-29.edison.json) - [package](https://docs.nomos.energy/package.json) - [openapi](https://docs.nomos.energy/api-reference/openapi.yaml)