> ## 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.

# Changelog

> What changed between Nomos API versions.

Each entry below corresponds to a date-based version you can pin per Auth Client or per request. See [Versioning](/api-references/versioning) for how to upgrade.

<Update label="2026-05-27.curie">
  **Breaking changes**

  * `GET /subscriptions/{id}/invoices` is removed. Use the new top-level `GET /invoices` and filter with `filter[subscription][eq]=<id>` to scope to a single subscription. Older versions keep the nested route.
  * `GET /subscriptions/{id}/meter_readings` and `POST /subscriptions/{id}/meter_readings` are removed. Use the new top-level `GET /meter-readings` (with `filter[subscription][eq]=<id>`) and `POST /meter-readings` (with the subscription in the body) instead.
  * `GET /suppliers/search` is removed. Use the new top-level `GET /market_partners`.
  * `GET /suppliers` is removed. Use the new top-level `GET /market_partners`.

  **New endpoints**

  * `GET /invoices`, `GET /invoices/{id}`: list and retrieve a customer's invoices across all subscriptions in one call. Customer tokens are scoped to their own invoices.
  * `POST /subscriptions/{id}/terminate`: terminate a subscription with one of three reasons via a discriminated `reason` field: `ORDINARY` (optional notice period), `MOVE_OUT` (mandatory move-out date), or `WITHDRAWAL` (14-day cooling-off period).
  * `GET /meter-readings`, `POST /meter-readings`: top-level meter-readings list and submission.
  * `GET /market-partners`: list German electricity retailers for previous-supplier selection in checkout flows.
  * `PATCH /subscriptions/{id}`: change the billing address, payment method or metadata of the subscription

  **New features**

  * Plans and subscriptions include a `type` field (`consumption` or `feed_in`). Feed-in plans are available from this version onwards; on earlier versions they stay hidden from the plans endpoints. See [Feed-in](/guides/feed-in).
  * Invoices now expose two additional `type` values alongside `usage`: `prepayment` (fixed advance charge with no metered consumption) and `void` (a reversal document that cancels a previously paid invoice).
  * Invoice `status` now includes `voided` and `uncollectible` in addition to the existing values. Filter expressions accept the new values.
  * Structured error responses: validation failures return an `errors[]` array with one entry per invalid field, each describing what's wrong with that field. Date-query messages were rewritten to be clearer about expected formats. Pre-curie versions keep the single-message shape.
</Update>

<Update label="2026-01-29.edison">
  **New endpoints**

  * `GET /grid-fee-reductions`: list grid fee reductions.
  * `GET /grid-fee-reductions/{id}`: retrieve a grid fee reduction.
  * `POST /grid-fee-reductions`: create a grid fee reduction for §14a EnWG modules.
  * `GET /meter-orders`: list meter orders.
  * `GET /meter-orders/{id}`: retrieve a meter order.
  * `POST /meter-orders`: create a meter order for a subscription.

  **New features**

  * All list endpoints now support [Filtering](/api-references/filtering).
</Update>

<Update label="2025-12-16.batman">
  **Breaking changes**

  * List endpoints are now paginated. See [Pagination](/api-references/pagination). Affects `/customers`, `/leads`, `/plans`, `/subscriptions`, `/subscriptions/{id}/invoices`, `/subscriptions/{id}/meter_readings`, `/suppliers`, and `/suppliers/search`.

  **New features**

  * Introduced [Versioning](/api-references/versioning). Routes stay the same; pin a version per Auth Client or per request via `X-API-Version`.
</Update>

<Update label="2025-12-01.chucky">
  Initial public version of the Nomos API.
</Update>