Skip to main content
Each entry below corresponds to a date-based version you can pin per Auth Client or per request. See Versioning for how to upgrade.
​
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.
  • 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.
​
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
​
2025-12-16.batman
Breaking changes
  • List endpoints are now paginated. See Pagination. Affects /customers, /leads, /plans, /subscriptions, /subscriptions/{id}/invoices, /subscriptions/{id}/meter_readings, /suppliers, and /suppliers/search.
New features
  • Introduced Versioning. Routes stay the same; pin a version per Auth Client or per request via X-API-Version.
​
2025-12-01.chucky
Initial public version of the Nomos API.