---
title: "Get Subscription Plans"
method: GET
path: "/api/v1/subscriptions/plans"
tags: ["subscriptions"]
---

# Get Subscription Plans

`GET /api/v1/subscriptions/plans`

## Request

- Base URL: `https://api.alert.camp` (the document declares no server; this is the origin it was published from)
- URL: `https://api.alert.camp/api/v1/subscriptions/plans`
- Auth: none declared

Get available subscription plans with capacity info.

- **v=2**: Returns full dynamic screen config (localized tiers, comparison
  table, feature list, provider site overrides).
- **No v param / v=1**: Returns legacy format (backwards compat for old app versions).

Plans are purchased via native IAP through RevenueCat SDK.

## Query parameters

- `v` integer, nullable: API version: 2 for dynamic screen config

## Response `200`

Successful Response

- union
  - SubscriptionPlansResponse: Schema for available subscription plans.
    - `plans` SubscriptionPlanInfo[]
      - `tier` 'essai' | 'regular' | 'pro', required: Subscription tier levels.
      - `name` string, required
      - `description` string, required
      - `price_cad` number, required
      - `interval` string
      - `features` string[], required
      - `capacity` integer, nullable
      - `current_subscribers` integer
      - `available_spots` integer, nullable
      - `is_available` boolean
    - `trial_days` integer
  - SubscriptionScreenConfigResponse: v2 response for /plans endpoint — full subscription screen config.
    - `version` integer
    - `tiers` TierTileConfig[]
      - `tier` string, required
      - `icon` string, required
      - `price_cad` number, required
      - `revenuecat_product_id` string, nullable
      - `name` string, required
      - `description` string, required
      - `badge` string, nullable
      - `features` TileFeatureRow[]
        - `icon` string, required
        - `text` string, required
        - `highlight` boolean
        - `highlight_color` string, nullable
    - `paid_tiers` string[]
    - `comparison_rows` ComparisonRowConfig[]
      - `label` string, required
      - `values` string[], required
      - `type` string, required
    - `features` FeatureItemConfig[]
      - `icon` string, required
      - `title` string, required
      - `description` string, required
    - `provider_site_overrides` object
    - `capacity` object
    - `provider_config` object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/alert/apis/alertcamp.md) · [All operations](https://skmtc.dev/alert/apis/alertcamp/llms.txt) · [OpenAPI document](https://skmtc.dev/alert/apis/alertcamp/revisions/864c8c9ef833?raw)