Skip to main content
GET
/
plans
/
{id}
/
quote
Retrieve a quote
curl --request GET \
  --url https://api.nomos.energy/plans/{id}/quote \
  --header 'Authorization: Bearer <token>'
{
  "amount": 71.9,
  "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",
  "discount": {
    "name": "Early bird discount",
    "amount_off": 10,
    "duration": "recurring",
    "duration_in_months": 10,
    "regular_amount": 60
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required
Example:

"pln_1"

Query Parameters

​
zip_code
string
required

ZIP code for the delivery address

Example:

"10115"

​
usage
number
required

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

Required range: 100 <= x <= 50000
Example:

2500

​
meter_type
enum<string>
default:analog

Type of the meter

Available options:
analog,
smart
Example:

"analog"

​
14a_module_1
boolean | null
default:false

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_2
boolean | null
default:false

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

​
customer_type
enum<string>
default:person

Type of the prospective customer. Together with vat_id, this determines the VAT treatment of feed-in payouts; consumption quotes are unaffected.

Available options:
person,
company
Example:

"person"

​
vat_id
string

VAT ID (USt-IdNr.) of the prospective customer, if they have one. For feed-in plans, a person without one is treated as VAT-exempt (§ 19 UStG) and quoted the net payout.

Example:

"DE123456789"

Response

Retrieve the quote details

​
object
enum<string>
required
Available options:
quote
​
amount
number
required

Total amount of the quote

Example:

71.9

​
currency
enum<string>
required

Currency of the quote

Available options:
EUR
​
components
object[]
required

Components of the quote

Example:
[
  {
    "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
string<date-time>
required

When this quote was generated

Example:

"2024-10-30T16:04:06.122Z"

​
discount
object