---
title: "Get a subscription plan by ID"
method: GET
path: "/api/v3/subscriptions/plans/{planId}"
tags: ["Plans"]
---

# Get a subscription plan by ID

`GET /api/v3/subscriptions/plans/{planId}`

## Path parameters

- `planId` string, uuid, required

## Response `200`

Plan found.

- Plan
  - `id` string, uuid, required
  - `name` string, required
  - `type` 'FIXED' | 'VARIABLE', required — How a plan's billed amount is determined. `FIXED` — the plan carries a fixed `price`; every subscription bills it. `VARIABLE` — the plan carries only an `asset`; the amount is set per subscription at creation.
  - `asset` string, required — The plan's billing asset. Always present (equals `price.asset` for `FIXED` plans).
  - `price` Price — Monetary amount. `amount` is a decimal string. `asset` is an ISO 4217 code for fiat or an uppercase stablecoin symbol — e.g. `USD`, `EUR`, `USDC`, `USDT`.
    - `amount` string, required
    - `asset` string, required
  - `billingInterval` 'MONTHLY' | 'ANNUAL', required — How often the subscription is billed.
  - `termCycles` integer, nullable — Number of billing cycles in the plan's term; null means it renews indefinitely.
  - `gracePeriod` string, required — ISO-8601 calendar period. Examples: `P7D` (7 days), `P1M` (1 month), `P1Y` (1 year). Sub-day precision is not supported.
  - `status` 'ACTIVE' | 'ARCHIVED', required — `ACTIVE` — open for new subscriptions. `ARCHIVED` — closed to new subscriptions; existing subscriptions keep billing.
  - `createdAt` integer, required — Unix epoch seconds.
  - `updatedAt` integer, required — Unix epoch seconds.

## Other responses

- `401` — Caller is unauthenticated.
- `403` — Caller is authenticated but not authorized for this resource.
- `404` — Resource not found.
- `500` — Unexpected server error.

---

[API](https://skmtc.dev/confirmo/apis/confirmo-subscribe-api.md) · [All operations](https://skmtc.dev/confirmo/apis/confirmo-subscribe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/confirmo/confirmo-subscribe-api/revisions/105015030952/schema)