# 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. Not applicable for feed-in subscriptions, which do not pay grid fees. - [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. Leads for feed-in plans are only available from the `2026-05-27.curie` API version onwards. - [Retrieve a lead](https://docs.nomos.energy/api-reference/leads/retrieve-a-lead.md): Retrieve lead details by its id. Feed-in plans require the `2026-05-27.curie` API version or later; retrieving a lead for one returns `400 BAD_REQUEST`. - [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. Quotes are only available for consumption plans on this API version; feed-in plans require the `2026-05-27.curie` API version or later, and quoting one here returns `400 BAD_REQUEST`. - [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. Feed-in subscriptions are only available from the `2026-05-27.curie` API version onwards; requesting one returns `400 BAD_REQUEST`. - [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. Not applicable for feed-in subscriptions, as a smart meter must be present before starting a feed-in subscription. - [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): Authenticate with the Nomos API using OAuth 2.0. - [Changelog](https://docs.nomos.energy/api-references/changelog.md): What changed between Nomos API versions. - [Errors](https://docs.nomos.energy/api-references/errors.md): Decode the Nomos error envelope and handle each error code. - [Filtering](https://docs.nomos.energy/api-references/filtering.md): Narrow list endpoints with bracket-notation query filters. - [API Reference](https://docs.nomos.energy/api-references/introduction.md): Understand general concepts, response codes, and authentication strategies. - [Pagination](https://docs.nomos.energy/api-references/pagination.md): Walk list endpoints with cursor-based pagination. - [Versioning](https://docs.nomos.energy/api-references/versioning.md): Pin an API version per Auth Client or per request. - [AI agents](https://docs.nomos.energy/guides/ai-agents.md): Give a coding or operations agent working knowledge of the Nomos API with an installable skill. - [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. - [Feed-in](https://docs.nomos.energy/guides/feed-in.md): Sign up customers who feed solar power into the grid, with Nomos handling grid registration, metering, and monthly credits. - [Grid Fee Reductions (§14a EnWG)](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. - [Checkout](https://docs.nomos.energy/guides/hosted-checkout.md): Your brand, your Checkout. - [Customer Portal](https://docs.nomos.energy/guides/hosted-customer-portal.md): Designed for self-service. - [Leads & Checkout Links](https://docs.nomos.energy/guides/leads.md): Designed for one-tap signup. - [Load Shifting and Optimization](https://docs.nomos.energy/guides/load-shifting.md): Pull a customer's 15-minute electricity prices, shift their flexible loads into the cheap intervals, and verify the result against actual consumption. - [Portal Single Sign-On](https://docs.nomos.energy/guides/magic-link.md): Designed to skip the second sign-in. - [Smart Meter Installation Partnerships](https://docs.nomos.energy/guides/order-smart-meters.md): Order smart meters (iMSys) for your customers on a predictable timeline through Nomos's wMSB partnerships, the precondition for dynamic pricing, §14a savings, and HEMS integrations. - [Pricing Breakdown](https://docs.nomos.energy/guides/pricing.md): Render checkout quote breakdowns and customer-portal price displays for a German dynamic tariff, layer by layer. - [Third-Party Login](https://docs.nomos.energy/guides/third-party-oauth.md): Designed for customer-consented access. - [Nomos Documentation](https://docs.nomos.energy/home.md): Guides, API reference, and webhooks for the Nomos energy platform. - [Quickstart](https://docs.nomos.energy/quickstart.md): Pick your integration path and set up API access in under five minutes. - [subscription.activated](https://docs.nomos.energy/webhooks/events/subscription-activated.md): Sent when a customer's supply starts. - [subscription.confirmed](https://docs.nomos.energy/webhooks/events/subscription-confirmed.md): Sent when a customer's supply start date is confirmed. - [subscription.created](https://docs.nomos.energy/webhooks/events/subscription-created.md): Sent when a customer completes signup. - [subscription.ended](https://docs.nomos.energy/webhooks/events/subscription-ended.md): Sent when a customer's supply ends. - [subscription.terminated](https://docs.nomos.energy/webhooks/events/subscription-terminated.md): Sent when a customer schedules cancellation. - [Webhooks](https://docs.nomos.energy/webhooks/introduction.md): Receive real-time updates from the Nomos API as signed HTTPS requests. - [How to receive webhooks](https://docs.nomos.energy/webhooks/receiving.md): To receive real-time events in your app via webhooks, follow these steps. - [Retries](https://docs.nomos.energy/webhooks/retries.md): Handle webhook failures with exponential backoff. - [Verify webhook requests](https://docs.nomos.energy/webhooks/verify-requests.md): Reject forged and replayed webhook deliveries before they reach your handlers. ## OpenAPI Specs - [openapi.2025-12-16.batman](https://api.nomos.energy/openapi.2025-12-16.batman.json) - [openapi.2025-12-01.chucky](https://api.nomos.energy/openapi.2025-12-01.chucky.json) - [openapi.2026-05-27.curie](https://api.nomos.energy/openapi.2026-05-27.curie.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)