NOnomos
Grid Fee Reductions

Create a grid fee reduction

Changed on

Create a new grid fee reduction for §14a EnWG modules. Not applicable for feed-in subscriptions, which do not pay grid fees.

Grid fee reduction status:

  • If the subscription is active: grid fee reduction is created with ordered status. Order is submitted immediately
  • If the subscription is pending: grid fee reduction is created with intended status. Order will be submitted once the subscription is confirmed

Re-ordering after rejection: Re-ordering is allowed if the previous grid fee reduction was rejected or ended.

Ended and terminated subscriptions: From 2026-09-08.gauss, a subscription that has ended is refused with ended_subscription, and one with terminated_at set with terminated_subscription.

post/grid-fee-reductions

Request

  • Base URL
    https://api.nomos.energy
  • URL
    https://api.nomos.energy/grid-fee-reductions
  • Auth
    HTTP bearer

Request body

subscriptionstring required

ID of the subscription

type'enwg-14a-module-1' | 'enwg-14a-module-2' | 'enwg-14a-module-3' required

Grid fee reduction module type according to §14a EnWG

Example request

{
  "subscription": "sub_mi4f0oda6x9m7gcsvjk0ole1",
  "type": "enwg-14a-module-1"
}

Response

The newly created grid fee reduction.

object'grid_fee_reduction' required

Type of the object, always 'grid_fee_reduction'

idstring required

Unique identifier for the grid fee reduction

subscriptionstring required

ID of the subscription

type'enwg-14a-module-1' | 'enwg-14a-module-2' | 'enwg-14a-module-3' required

Grid fee reduction module type according to §14a EnWG

status'intended' | 'ordered' | 'rejected' | 'activated' | 'ended' required

Current status of the grid fee reduction order

valid_fromstring date-time nullable required

Start date of the grid fee reduction validity period

valid_untilstring date-time nullable required

End date of the grid fee reduction validity period

created_atstring date-time required

Timestamp when the grid fee reduction was created

updated_atstring date-time required

Timestamp when the grid fee reduction was last updated

customerstring required

ID of the customer the grid fee reduction belongs to

Example response

{
  "id": "gfr_mi4f0oda6x9m7gcsvjk0ole1",
  "subscription": "sub_mi4f0oda6x9m7gcsvjk0ole1",
  "type": "enwg-14a-module-1",
  "status": "activated",
  "valid_from": "2026-04-01T00:00:00Z",
  "created_at": "2026-03-02T09:15:00Z",
  "updated_at": "2026-04-01T06:30:00Z",
  "customer": "cus_mi4f0oda6x9m7gcsvjk0ole1"
}

Changes

  • ae823aac7088Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the custom enum value from the // response property for the response status

    • info

      removed the custom enum value from the // response property for the response status

    • info

      removed the duplicate_customer_email enum value from the // response property for the response status

    • info

      removed the duplicate_customer_email enum value from the // response property for the response status

    • info

      removed the duplicate_grid_reduction enum value from the // response property for the response status

    • info

      removed the duplicate_grid_reduction enum value from the // response property for the response status

    • info

      removed the duplicate_meter_order enum value from the // response property for the response status

    • info

      removed the duplicate_meter_order enum value from the // response property for the response status

    • info

      removed the duplicate_meter_reading enum value from the // response property for the response status

    • info

      removed the duplicate_meter_reading enum value from the // response property for the response status

    • info

      removed the ended_subscription enum value from the // response property for the response status

    • info

      removed the ended_subscription enum value from the // response property for the response status

    • info

      removed the implausible_meter_reading enum value from the // response property for the response status

    • info

      removed the implausible_meter_reading enum value from the // response property for the response status

    • info

      removed the invalid_element enum value from the // response property for the response status

    • info

      removed the invalid_element enum value from the // response property for the response status

    • info

      removed the invalid_format enum value from the // response property for the response status

    • info

      removed the invalid_format enum value from the // response property for the response status

    • info

      removed the invalid_iban enum value from the // response property for the response status

    • info

      removed the invalid_iban enum value from the // response property for the response status

    • info

      removed the invalid_key enum value from the // response property for the response status

    • info

      removed the invalid_key enum value from the // response property for the response status

    • info

      removed the invalid_termination_date enum value from the // response property for the response status

    • info

      removed the invalid_termination_date enum value from the // response property for the response status

    • info

      removed the invalid_type enum value from the // response property for the response status

    • info

      removed the invalid_type enum value from the // response property for the response status

    • info

      removed the invalid_union enum value from the // response property for the response status

    • info

      removed the invalid_union enum value from the // response property for the response status

    • info

      removed the invalid_value enum value from the // response property for the response status

    • info

      removed the invalid_value enum value from the // response property for the response status

    • info

      removed the missing_module_1 enum value from the // response property for the response status

    • info

      removed the missing_module_1 enum value from the // response property for the response status

    • info

      removed the missing_smart_meter enum value from the // response property for the response status

    • info

      removed the missing_smart_meter enum value from the // response property for the response status

    • info

      removed the not_multiple_of enum value from the // response property for the response status

    • info

      removed the not_multiple_of enum value from the // response property for the response status

    • info

      removed the out_of_period_meter_reading enum value from the // response property for the response status

    • info

      removed the out_of_period_meter_reading enum value from the // response property for the response status

    • info

      removed the subscription_not_started enum value from the // response property for the response status

    • info

      removed the subscription_not_started enum value from the // response property for the response status

    • info

      removed the too_big enum value from the // response property for the response status

    • info

      removed the too_big enum value from the // response property for the response status

    • info

      removed the too_small enum value from the // response property for the response status

    • info

      removed the too_small enum value from the // response property for the response status

    • info

      removed the unrecognized_keys enum value from the // response property for the response status

    • info

      removed the unrecognized_keys enum value from the // response property for the response status

    • info

      removed the unserviceable_zip enum value from the // response property for the response status

    • info

      removed the unserviceable_zip enum value from the // response property for the response status

    • info

      removed the unsupported_meter enum value from the // response property for the response status

    • info

      removed the unsupported_meter enum value from the // response property for the response status

    • info

      removed the unsupported_meter_order enum value from the // response property for the response status

    • info

      removed the unsupported_meter_order enum value from the // response property for the response status

    • info

      removed the unsupported_meter_reading enum value from the // response property for the response status

    • info

      removed the unsupported_meter_reading enum value from the // response property for the response status

    • info

      removed the unsupported_product enum value from the // response property for the response status

    • info

      removed the unsupported_product enum value from the // response property for the response status

    • info

      removed the upgrade_api_version enum value from the // response property for the response status

    • info

      removed the upgrade_api_version enum value from the // response property for the response status

    • info

      removed the withdrawal_not_allowed enum value from the // response property for the response status

    • info

      removed the withdrawal_not_allowed enum value from the // response property for the response status