Calculate a quote
Price a plan for one delivery address and one annual usage. 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 grid fee reductions only apply to consumption plans, as feed-in plans pay no grid fees.
This replaces GET /plans/{id}/quote, which is not served from the 2026-09-08.gauss API version onwards: same path, POST instead of GET. The inputs moved into a body so the §14a EnWG modules travel as one grid_fee_reductions object, and so the response of Calculate savings can be posted here field for field: usage.consumption, optimization_rate and grid_fee_reductions are named the same on both sides. There is no meter_type any more either: it follows from the optimization rate that gets priced, since load shifting needs a smart meter. Nothing is read or written; the quote is computed and discarded.
Two changes to the response from this version onwards. The load-shifting discount is a subcomponent of its own (subgroup: "optimization", a negative amount) instead of being folded into energy, so energy is the undiscounted day-ahead average and the subcomponents still sum to unit_amount. And with 14a_module_3, the grid subcomponent is the operator’s low, standard and high windows blended over the share of the year the schedule is in effect, rather than the static rate.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
"pln_1"
Body
The household to price the plan for
ZIP code for the delivery address
"10115"
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.
100 <= x <= 500003907
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.
0 <= x <= 10.18
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.
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
The priced quote
quote Total amount of the quote
71.9
Currency of the quote
EUR The period every amount on the quote covers. Quotes state the monthly bill.
month "month"
Components of the quote
When this quote was generated
"2024-10-30T16:04:06.122Z"