Plans
Get a quote
Getting Started
Authentication
API Reference
- OAuth
- Plans
- Subscriptions
- Suppliers
- Prices
- Beta
Error Codes
- Introduction
- Error Types
Plans
Get a quote
Retrieve a quote details by its id
GET
/
plans
/
{id}
/
quote
curl --request GET \
--url https://api.nomos.energy/plans/{id}/quote \
--header 'Authorization: Bearer <token>'
{
"object": "quote",
"amount": 71.9,
"currency": "EUR",
"discount": {
"name": "Early bird discount",
"amount_off": 10,
"duration": "recurring",
"duration_in_months": 10,
"regular_amount": 60
},
"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
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Example:
"pln_1"
Query Parameters
ZIP code for the delivery address
Example:
"10115"
Annual electricity usage in kWh. Must be between 100 and 50000
Required range:
100 <= x <= 50000
Example:
2500
Type of the meter
Available options:
analog
, smart
Example:
"analog"
Response
200
application/json
Retrieve the quote details
The response is of type object
.
curl --request GET \
--url https://api.nomos.energy/plans/{id}/quote \
--header 'Authorization: Bearer <token>'
{
"object": "quote",
"amount": 71.9,
"currency": "EUR",
"discount": {
"name": "Early bird discount",
"amount_off": 10,
"duration": "recurring",
"duration_in_months": 10,
"regular_amount": 60
},
"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"
}