---
title: "List plans"
method: GET
path: "/api/v1.4/subscriptions/plans/"
tags: ["v1.1"]
---

# List plans

`GET /api/v1.4/subscriptions/plans/`

List all created plans

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

- PaginatedPlanVersionDetailsList
  - `count` integer
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` PlanVersionDetails[]
    - `id` string, required
    - `name` string, required — Plan name.
    - `description` string, required — Plan description.
    - `currency` string, required — The currency of the plan represented by a string of alphabetic code from ISO 4217 Currency codes.
    - `amount` number, double, required — Plan's base amount to be used in subscription invoices.
    - `one_time_fee` string, required — One time fee will be added once to the first subscription invoice when subscripting to this plan.
    - `trial_period` integer, nullable, required — Number of trial days before the first recurring cycle.
    - `recurrency` integer, required — The interval at which a subscription is charged.
    - `recurrency_unit` string, required — The time unit used to define the recurrency. DAY and MONTH are supported
    - `recurring_cycles` integer, nullable, required — The total number of payment cycles in the subscription lifetime. if empty the subscription will be charged forever till canceled.
    - `discount_amount` string, required — Discount amount applied.
    - `discount_percentage` string, decimal, nullable, required — Discount percentage applied.
    - `discount_cycles` integer, nullable, required — How many cycles the discount will be applied to.
    - `is_live` boolean, required
    - `created` string, required

## Other responses

- `401`

---

[API](https://skmtc.net/moneyhash/apis/moneyhash-api.md) · [All operations](https://skmtc.net/moneyhash/apis/moneyhash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moneyhash/moneyhash-api/versions/111e4c2e0826/schema)