NOnomos
Smart Meter Orders

Create a smart meter order

Changed on

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. 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/meter-orders

Request

  • Base URL
    https://api.nomos.energy
  • URL
    https://api.nomos.energy/meter-orders
  • Auth
    HTTP bearer

Request body

subscriptionstring required

ID of the subscription to create the meter order for

Example request

{
  "subscription": "sub_mi4f0oda6x9m7gcsvjk0ole1"
}

Response

The created meter order details

object'meter_order' required

Type of the object, always 'meter_order'

idstring required

Unique identifier for the meter order

subscriptionstring required

ID of the subscription

customerstring required

ID of the customer

provider'energy-metering' | 'metrify' | 'inexogy' required

The smart meter provider

status'waiting' | 'ordered' | 'checked' | 'installation_planning' | 'installation_scheduled' | 'installation_waiting' | 'installation_finished' | 'activated' | 'installed' | 'pre_installed' | 'cancelled' | 'intended' | 'blocked' | 'blocked_wim' required

Current status of the meter order.

Possible values:

  • waiting: The customer has requested a smart meter - waiting to transfer the order to the meter provider (e.g. missing MaLo, MeLo,..)
  • ordered: We have transferred the order to the meter provider
  • checked: The meter provider did a smart meter check and confirmed to process the order
  • installation_planning: The meter provider is planning the installation (e.g. waiting for the customer to confirm the installation date)
  • installation_scheduled: The meter provider has scheduled the installation with the customer (e.g. waiting for the customer to confirm the installation date)
  • installation_waiting: The meter provider is waiting for the installation to start (e.g. waiting for the customer to confirm the installation date)
  • installation_finished: The meter provider has finished the installation and the new meter data has been transferred to the network operator
  • activated: The smart meter is activated and can be used for automatic consumption data transmission
  • installed: The smart meter is installed
  • pre_installed: There is already a smart meter installed - no installation is needed
  • cancelled: The order has been cancelled
  • intended: The customer shows interest but has not yet completed the order
  • blocked: The order is artificially blocked by our system - waiting for admin approval
  • blocked_wim: The smart meter is blocked in Wechselprozess im Messwesen (WiM) - waiting for the network operator to confirm the installation

Example response

{
  "id": "smo_mi4f0oda6x9m7gcsvjk0ole1",
  "subscription": "sub_mi4f0oda6x9m7gcsvjk0ole1",
  "customer": "cus_mi4f0oda6x9m7gcsvjk0ole1",
  "provider": "energy-metering",
  "status": "waiting"
}

Changes

  • ae823aac7088Revision changes
    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required 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

    • warning

      removed the optional property from the response with the status

    • warning

      added the new blocked enum value to the response property for the response status

    • warning

      added the new blocked_wim enum value to the response property for the response status

    • warning

      added the new checked enum value to the response property for the response status

    • warning

      added the new installation_finished enum value to the response property for the response status

    • warning

      added the new installation_planning enum value to the response property for the response status

    • warning

      added the new installation_scheduled enum value to the response property for the response status

    • warning

      added the new installation_waiting enum value to the response property for the response status

    • warning

      added the new intended enum value to the response property for the response status

    • warning

      added the new ordered enum value to the response property for the response status

    • warning

      added the new pre_installed enum value to the response property for the response status

    • warning

      added the new waiting enum value to the response property for the response 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 check_reviewed enum value from the response property for the response status

    • info

      removed the check_submitted enum value from the response property for the response status

    • info

      removed the created 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 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_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_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_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 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 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 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_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_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_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_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_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_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_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 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_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 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 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 out_of_period_meter_reading enum value from the // response property for the response status

    • info

      removed the placed enum value from the response property for the response status

    • info

      removed the scheduled 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 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_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 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 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 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 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_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_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 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 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

    • info

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

    • info

      added the required property to the response with the status