---
title: "List the pricing plans"
method: GET
path: "/plans"
tags: ["Commerce"]
---

# List the pricing plans

`GET /plans`

## Request

- Base URL: `https://grape.cool/api/v1`
- URL: `https://grape.cool/api/v1/plans`
- Auth: none required

Returns the Free, Sync, Plus, Pro and Lifetime plans with the price, the billing period and the full feature list of each. Prices are in US dollars.

## Response `200`

Five plans, cheapest first.

- object
  - `success` true, required
  - `data` Plan[], required
    - `id` string, required: Stable plan identifier.
    - `name` string, required: Plan name.
    - `price` string, required: Price as published, including the currency symbol.
    - `period` string, required: What the price buys, such as per month or one time.
    - `description` string: Who the plan is for.
    - `features` string[], required: Everything the plan includes.
    - `callToAction` string: The button label on the pricing page.
    - `url` string, uri
  - `meta` Meta: Counts and echoed arguments that describe the payload.
    - `total` integer: How many items exist.
    - `returned` integer: How many items this response carries.
    - `query` string: The search term that was used.
    - `currency` string: ISO 4217 code the prices are quoted in.

## Other responses

- `400`: A parameter was missing or outside the allowed values.
- `404`: Nothing matches the identifier given.
- `429`: More than 1000 requests came from this IP address in an hour.
- `500`: The request could not be completed.

---

[API](https://skmtc.dev/grape/apis/grape-public-api.md) · [All operations](https://skmtc.dev/grape/apis/grape-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/grape/apis/grape-public-api/revisions/16061cbac2d4?raw)