---
title: "Retrieve a quote"
method: GET
path: "/plans/{id}/quote"
tags: ["Plans"]
---

# Retrieve a quote

`GET /plans/{id}/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.

## Path parameters

- `id` string, required

## Query parameters

- `zip_code` string, required — ZIP code for the delivery address
- `usage` number, required — Annual electricity usage in kWh. Must be between 100 and 50000
- `meter_type` 'analog' | 'smart' — Type of the meter
- `14a_module_1` boolean, nullable — 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`.
- `14a_module_2` boolean, nullable — 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`.
- `is_tax_exempt` boolean — Whether the prospective customer is exempt from VAT. Private operators are typically exempt as Kleinunternehmer under [§ 19 UStG](https://www.gesetze-im-internet.de/ustg_1980/__19.html) 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.

## Response `200`

Retrieve the quote details

- Quote
  - `object` 'quote', required
  - `amount` number, required — Total amount of the quote
  - `currency` 'EUR', required — Currency of the quote
  - `discount` QuoteDiscount
    - `name` string, required — Name of the discount
    - `amount_off` number, required — Amount off for the discount
    - `duration` string, required — Duration either 'once' or 'recurring'
    - `duration_in_months` number, nullable, required — Duration in months for the discount if recurring
    - `regular_amount` number, required — Regular amount without the discount
  - `components` QuoteComponent[], required — Components of the quote
    - `group` 'base' | 'variable', required — Component group type
    - `amount` number, required — Total amount for this component group
    - `quantity` number, required — Quantity of the component group
    - `quantity_unit` 'month' | 'kWh', required — Unit for the quantity
    - `unit_amount` number, required — Amount per unit for this component group
    - `subcomponents` QuoteSubcomponent[], required
      - `subgroup` 'fee' | 'grid' | 'metering' | 'energy' | 'levies', required — Component subgroup type
      - `name` string, required — Display name of the component
      - `amount` number, required — Amount for this component
  - `quoted_at` string, date-time, required — When this quote was generated

## Other responses

- `400` — The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).
- `401` — The client must authenticate itself to get the requested response.
- `402` — A higher pricing plan is required to access the resource.
- `403` — The client does not have the necessary permissions to access the resource.
- `404` — The server can't find the requested resource.
- `405` — The request method is not allowed.
- `409` — The request could not be completed due to a conflict mainly due to unique constraints.
- `422` — The request was well-formed but was unable to be followed due to semantic errors.
- `429` — The client has sent too many requests.
- `500` — The server has encountered a situation it doesn't know how to handle.

---

[API](https://skmtc.dev/nomos/apis/nomos-api.md) · [All operations](https://skmtc.dev/nomos/apis/nomos-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nomos/nomos-api/revisions/da60ad83e92f/schema)
