NOnomos
Plans

Retrieve a quote

Changed on

Retrieve a quote details by its id. All prices are inclusive of VAT, with one exception: feed-in payouts to a tax-exempt customer (is_tax_exempt: true, e.g. a Kleinunternehmer under § 19 UStG) are quoted without VAT, matching what the customer is later credited. The §14a EnWG module options only apply to consumption plans as feed-in plans do not pay grid fees.

get/plans/{id}/quote

Request

  • Base URL
    https://api.nomos.energy
  • URL
    https://api.nomos.energy/plans/{id}/quote
  • Auth
    HTTP bearer

Path parameters

idstring required
Example:pln_bn1sny3aczwq5jkz8xcf4klf

Query parameters

zip_codestring required

ZIP code for the delivery address

Example:10115
usagenumber required

Annual electricity usage in kWh. Must be between 100 and 50000

Example:2500
meter_type'analog' | 'smart'

Type of the meter

Example:analog
14a_module_1boolean nullable

Whether to include §14a EnWG Module 1 (Pauschale Netzentgeltreduktion) in the quote. Only applicable to consumption plans; requests for feed-in plans are rejected with 400 BAD_REQUEST.

Example:true
14a_module_2boolean nullable

Whether to include §14a EnWG Module 2 (Prozentuale Netzentgeltreduktion) in the quote. Only applicable to consumption plans; requests for feed-in plans are rejected with 400 BAD_REQUEST.

Example:true
is_tax_exemptboolean

Whether the prospective customer is exempt from VAT. Private operators are typically exempt as Kleinunternehmer under § 19 UStG when their revenue stayed under 25,000 EUR the previous year and stays under 100,000 EUR the current year; companies are not. Only affects feed-in plans. Consumption plans are always quoted inclusive of VAT.

Response

Retrieve the quote details

object'quote' required
amountnumber required

Total amount of the quote

currency'EUR' required

Currency of the quote

quoted_atstring date-time required

When this quote was generated

Example response

{
  "amount": 71.9,
  "discount": {
    "name": "Early bird discount",
    "amount_off": 10,
    "duration": "recurring",
    "duration_in_months": 10,
    "regular_amount": 60
  },
  "components": [
    {
      "group": "base",
      "amount": 4.35,
      "quantity": 1,
      "quantity_unit": "month",
      "unit_amount": 4.35,
      "subcomponents": [
        {
          "subgroup": "fee",
          "name": "Grundgebühr",
          "amount": 10.99
        },
        {
          "subgroup": "grid",
          "name": "Netzentgelte",
          "amount": 3.31
        },
        {
          "subgroup": "grid",
          "name": "Pauschale Netzentgeltreduktion (§14a EnWG Modul 1)",
          "amount": -11.21
        },
        {
          "subgroup": "metering",
          "name": "Messstellengebühren",
          "amount": 1.26
        }
      ]
    },
    {
      "group": "variable",
      "amount": 56.34,
      "quantity": 208,
      "quantity_unit": "kWh",
      "unit_amount": 0.27042,
      "subcomponents": [
        {
          "subgroup": "energy",
          "name": "EPEX Day-Ahead Preis (12m avg.)",
          "amount": 0.0877
        },
        {
          "subgroup": "grid",
          "name": "Netzentgelte",
          "amount": 0.1111
        },
        {
          "subgroup": "levies",
          "name": "Konzessionsabgabe",
          "amount": 0.0284
        },
        {
          "subgroup": "levies",
          "name": "Stromsteuer",
          "amount": 0.0244
        },
        {
          "subgroup": "levies",
          "name": "Offshore-Umlage",
          "amount": 0.0078
        },
        {
          "subgroup": "levies",
          "name": "§19-NEV Umlage",
          "amount": 0.0077
        },
        {
          "subgroup": "levies",
          "name": "KWK-Umlage",
          "amount": 0.0033
        }
      ]
    }
  ],
  "quoted_at": "2024-10-30T16:04:06.122Z"
}

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