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

# Retrieve a plan

`GET /api/v1/plans/{id}`

Required scope: `plans:read` </br>Organization authorization: `supported`

## Path parameters

- `id` integer, required

## Response `200`

Plan with provided id

- Plan
  - `id` integer, required — The id of the Plan
  - `identifier` string, required — A unique, readable, identifier of the Plan
  - `name` string, required — Name of the Plan
  - `countryId` integer, nullable — Determines the country where the plan is available. `null` means it is available in all countries.
  - `description` string, nullable — Description of the Plan
  - `summary` string, nullable — Summary of the Plan
  - `terms` string, nullable — Terms of the Plan
  - `contractUrl` string, nullable — URL for a generic contract template the user can fill out right after subscribing
  - `supportEmail` string, nullable — Support E-Mail for this Plan
  - `applicableFor` 'charge-point' | 'team' | 'operator', required
  - `active` boolean, required — Indicates if the plan is active (only active plans can be applied).
  - `applicationAudience` 'all' | 'own', required
  - `visibleInMarketPlace` boolean, required — Indicates whether this plan is shown in the market place or not.
  - `priceModel` 'fixed' | 'per-charge-point', required
  - `prices` PlanPrice[], required — Active plan prices
    - `id` integer — id of the Plan Price
    - `price` number, double — Price of the plan
    - `currency` Currency1, required
      - `identifier` string, required — Currency identifier, e.g. dkk
      - `name` string, required — Readable name of currency
      - `decimals` integer — Number of decimals for this currency
  - `pricesWithVat` boolean, required — Indicates if the prices are incl. VAT or not. Default is `true`.
  - `serviceType` 'custom' | 'tax-refund' | 'charge-package', required
  - `serviceConfig` union, required
    - object
      - `additionalFeeApplicationScope` 'all' | 'paid'
      - `additionalFeePercentage` integer, required — This percentage will be added as additional fee, paid by charge point owner.Will only be applied to charge point owned by operator.
      - `additionalFeeAbsolute` number, double, required — This absolute value will be added as additional fee, paid by charge point owner.Will only be applied to charge point owned by operator.Note: This uses the default currency of the operator!
      - `additionalStartingFee` number, double, required — This absolute value will be added as additional fee, once per charge session, paid by charge point owner.Will only be applied to charge point owned by operator.Note: This uses the default currency of the operator!
      - `roamingAdditionalFeePercentage` integer, nullable — Same as the additional fee percentage, but only applied to roaming sessions.
      - `roamingAdditionalFeeAbsolute` number, double, nullable — Same as the additional fee absolute, but only applied to roaming sessions.
      - `roamingAdditionalStartingFee` number, double, nullable — Same as the additional starting fee, but only applied to roaming sessions.
    - object
      - `additionalFeeApplicationScope` 'all' | 'paid'
      - `additionalFeePercentage` integer, required — This percentage will be added as additional fee, paid by charge point owner.Will only be applied to charge point owned by operator.
      - `additionalFeeAbsolute` number, double, required — This absolute value will be added as additional fee, paid by charge point owner.Will only be applied to charge point owned by operator.Note: This uses the default currency of the operator!
      - `payoutPerKwh` number, double, required — Amount to pay out per kWh
      - `priceIncludesVat` boolean, required — Indicates whether the VAT is already included in the price

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/revisions/517e18f11015/schema)