GET
/
plans
/
{plan}
/
quote
curl --request GET \
  --url https://api.nomos.energy/plans/{plan}/quote \
  --header 'Authorization: Bearer <token>'
{
  "object": "quote",
  "amount": 71.9,
  "currency": "EUR",
  "components": [
    {
      "group": "base",
      "amount": 15.56,
      "quantity": 1,
      "quantity_unit": "month",
      "unit_amount": 15.56,
      "subcomponents": [
        {
          "subgroup": "fee",
          "name": "Grundgebühr",
          "amount": 10.99
        },
        {
          "subgroup": "grid",
          "name": "Netzentgelte",
          "amount": 3.31
        },
        {
          "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 (6m 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"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
plan
string
required

ID of the plan to quote

Example:

"pln_ze28zs8xh9am05g65f05dnj7"

Query Parameters

​
zip_code
string
required

ZIP code for the delivery address

Example:

"10115"

​
usage
integer
required

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

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

2500

​
meter_type
enum<string>
required

Type of electricity meter

Available options:
smart,
analog
Example:

"smart"

Response

200
application/json
Successful response
​
object
string
required

Type of object is always quote.

​
amount
number
required

Total amount of the quote.

​
currency
string
required

Currency of the quoted amounts.

​
quoted_at
string
required

When this quote was generated.

​
components
object[]
Search SuppliersRetrieve a Subscription