---
title: "List plans"
method: GET
path: "/marketplace_listing/plans"
tags: ["apps"]
---

# List plans

`GET /marketplace_listing/plans`

Lists all plans that are part of your GitHub Marketplace listing.

GitHub Apps must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. OAuth apps must use [basic authentication](https://docs.github.com/rest/authentication/authenticating-to-the-rest-api#using-basic-authentication) with their client ID and client secret to access this endpoint.

## Query parameters

- `per_page` integer
- `page` integer

## Response `200`

Response

- MarketplaceListingPlan[]
  - `url` string, uri, required
  - `accounts_url` string, uri, required
  - `id` integer, required
  - `number` integer, required
  - `name` string, required
  - `description` string, required
  - `monthly_price_in_cents` integer, required
  - `yearly_price_in_cents` integer, required
  - `price_model` 'FREE' | 'FLAT_RATE' | 'PER_UNIT', required
  - `has_free_trial` boolean, required
  - `unit_name` string, nullable, required
  - `state` string, required
  - `bullets` string[], required

## Other responses

- `401` — Requires authentication
- `404` — Resource not found

---

[API](https://skmtc.net/github/apis/rest-api.md) · [All operations](https://skmtc.net/github/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/rest-api/revisions/80850db290cd/schema)