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

# Retrieve a plan

`GET /plans/{id}`

Retrieve a plan details by its id

## Path parameters

- `id` string, required

## Response `200`

Retrieve a plan details by its id

- Plan
  - `object` 'plan', required
  - `id` string, required — Unique identifier of the plan.
  - `name` string, required — Name of the plan.
  - `slug` string, required — Unique slug of the plan. Used to generate the [slug].checkout.energy or [slug].customerportal.energy url.
  - `description` string, required — Description of the plan.
  - `price` number, required — Monthly base fee charged excl. grid and metering operator fees, as well as taxes and levies. Includes VAT.
  - `currency` string, required — Currency of the fees.
  - `created_at` string, required — Date and time when the plan was created.
  - `type` 'consumption' | 'feed_in', required — Whether the plan covers electricity consumption or feed-in. Feed-in plans are only available from the 2026-05-27.curie API version onwards.

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