Retrieve a quote

curl --request GET \
  --url https://api.nomos.energy/plans/{id}/quote \
  --header 'Authorization: Bearer <token>'

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))

}

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
  }
}

GET

plans

{id}

quote

Retrieve a quote

curl --request GET \
  --url https://api.nomos.energy/plans/{id}/quote \
  --header 'Authorization: Bearer <token>'

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))

}

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
  }
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Example:

"pln_bn1sny3aczwq5jkz8xcf4klf"

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

is_tax_exempt

boolean

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.

Example:

false

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

Show child attributes

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

Show child attributes