---
title: "Retrieve plans"
method: GET
path: "/api/v1/plans"
tags: ["Plans"]
---

# Retrieve plans

`GET /api/v1/plans`

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

## Query parameters

- `page` integer
- `perPage` integer

## Response `200`

List of plans that match the criteria

- OffsetBasedResponse5
  - `data` Plan[], required
    - `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
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

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