---
title: "Get a subscription plan for an account"
method: GET
path: "/marketplace_listing/accounts/{account_id}"
tags: ["apps"]
---

# Get a subscription plan for an account

`GET /marketplace_listing/accounts/{account_id}`

Shows whether the user or organization account actively subscribes to a plan listed by the authenticated GitHub App. When someone submits a plan change that won't be processed until the end of their billing cycle, you will also see the upcoming pending change.

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.

## Path parameters

- `account_id` integer, required

## Response `200`

Response

- MarketplacePurchase — Marketplace Purchase
  - `url` string, required
  - `type` string, required
  - `id` integer, required
  - `login` string, required
  - `organization_billing_email` string
  - `email` string, nullable
  - `marketplace_pending_change` object, nullable
    - `is_installed` boolean
    - `effective_date` string
    - `unit_count` integer, nullable
    - `id` integer
    - `plan` MarketplaceListingPlan — Marketplace Listing Plan
      - `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
  - `marketplace_purchase` object, required
    - `billing_cycle` string
    - `next_billing_date` string, nullable
    - `is_installed` boolean
    - `unit_count` integer, nullable
    - `on_free_trial` boolean
    - `free_trial_ends_on` string, nullable
    - `updated_at` string
    - `plan` MarketplaceListingPlan — Marketplace Listing Plan
      - `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` — Not Found when the account has not purchased the listing

---

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