Skip to main content
POST
Calculate a quote

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"

Body

application/json

The household to price the plan for

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. Take it from usage.consumption on Calculate savings to price the household that was calculated there.

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

3907

optimization_rate
number

The share of the day-ahead price load shifting is expected to save, 0 to 1.

Omit it and the quote uses the plan's own rate, and a plan that configures none is quoted without optimization. Send a number and that rate is used instead, whatever the plan configures; 0 prices the plan without any optimization. Either way, no optimization means no optimization subcomponent at all rather than one of zero.

There is no meter type to send: load shifting needs a smart meter, so the quote prices one whenever the rate that applies is above zero and an analog meter otherwise. That decides the Messstellengebühren as well as the optimization row.

Take it from optimization_rate on Calculate savings to reprice that household's own asset mix. This is a display quote: the rate is taken as stated, and checkout re-derives it from the customer's own answers.

Required range: 0 <= x <= 1
Example:

0.18

grid_fee_reductions
object

The §14a EnWG grid fee reductions to price the quote with. Only applicable to consumption plans; requests for feed-in plans are rejected with 400 BAD_REQUEST.

is_tax_exempt
boolean
default:false

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

The priced quote

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
resolution
enum<string>
required

The period every amount on the quote covers. Quotes state the monthly bill.

Available options:
month
Example:

"month"

components
object[]
required

Components of the quote

Example:
quoted_at
string<date-time>
required

When this quote was generated

Example:

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

discount
object