curl --request GET \
--url https://api.nomos.energy/plans/{id}/quote \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.nomos.energy/plans/{id}/quote"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.nomos.energy/plans/{id}/quote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nomos.energy/plans/{id}/quote",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.nomos.energy/plans/{id}/quote"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.nomos.energy/plans/{id}/quote")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nomos.energy/plans/{id}/quote")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "quote",
"amount": 71.9,
"currency": "EUR",
"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
}
}{
"code": "BAD_REQUEST",
"message": "invalid_type in 'end': Required",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/BAD_REQUEST",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "UNAUTHORIZED",
"message": "Invalid or malformed token",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/UNAUTHORIZED",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "PAYMENT_REQUIRED",
"message": "Payment required",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/PAYMENT_REQUIRED",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "FORBIDDEN",
"message": "You are not allowed to access this resource",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/FORBIDDEN",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "NOT_FOUND",
"message": "Resource not found",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/NOT_FOUND",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "METHOD_NOT_ALLOWED",
"message": "Method not allowed",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/METHOD_NOT_ALLOWED",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "CONFLICT",
"message": "Resource already exists",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/CONFLICT",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "UNPROCESSABLE_ENTITY",
"message": "invalid_enum_value in 'status': Invalid enum value. Expected 'pending' | 'active' | 'ended'",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/UNPROCESSABLE_ENTITY",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "TOO_MANY_REQUESTS",
"message": "Wait 30 seconds before retrying.",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/TOO_MANY_REQUESTS",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/INTERNAL_SERVER_ERROR",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}Retrieve a quote
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.
curl --request GET \
--url https://api.nomos.energy/plans/{id}/quote \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.nomos.energy/plans/{id}/quote"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.nomos.energy/plans/{id}/quote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nomos.energy/plans/{id}/quote",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.nomos.energy/plans/{id}/quote"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.nomos.energy/plans/{id}/quote")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nomos.energy/plans/{id}/quote")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "quote",
"amount": 71.9,
"currency": "EUR",
"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
}
}{
"code": "BAD_REQUEST",
"message": "invalid_type in 'end': Required",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/BAD_REQUEST",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "UNAUTHORIZED",
"message": "Invalid or malformed token",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/UNAUTHORIZED",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "PAYMENT_REQUIRED",
"message": "Payment required",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/PAYMENT_REQUIRED",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "FORBIDDEN",
"message": "You are not allowed to access this resource",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/FORBIDDEN",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "NOT_FOUND",
"message": "Resource not found",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/NOT_FOUND",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "METHOD_NOT_ALLOWED",
"message": "Method not allowed",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/METHOD_NOT_ALLOWED",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "CONFLICT",
"message": "Resource already exists",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/CONFLICT",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "UNPROCESSABLE_ENTITY",
"message": "invalid_enum_value in 'status': Invalid enum value. Expected 'pending' | 'active' | 'ended'",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/UNPROCESSABLE_ENTITY",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "TOO_MANY_REQUESTS",
"message": "Wait 30 seconds before retrying.",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/TOO_MANY_REQUESTS",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}{
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error",
"requestId": "37a04f8f-e791-491c-81e1-86cd304649bb",
"docs": "https://docs.nomos.energy/api-references/errors/INTERNAL_SERVER_ERROR",
"errors": [
{
"code": "invalid_type",
"field": "favoriteNumbers.1",
"message": "Invalid input: expected string, received number"
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
"pln_1"
Query Parameters
ZIP code for the delivery address
"10115"
Annual electricity usage in kWh. Must be between 100 and 50000
100 <= x <= 500002500
Type of the meter
analog, smart "analog"
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.
true
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.
true
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.
false
Response
Retrieve the quote details
quote Total amount of the quote
71.9
Currency of the quote
EUR Components of the quote
Show child attributes
Show child attributes
[ { "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 } ] } ]
When this quote was generated
"2024-10-30T16:04:06.122Z"
Show child attributes
Show child attributes
Was this page helpful?