Get a subscription plan
GET /subscriptions/plans/{plan_id}| Scope | subscriptions:read |
| Customer session token | Not accepted: call from your server with an API key |
| Rate limit class | read (limits) |
| Idempotency key | Not used |
| MCP tool | charm_get_subscription_plan |
Parameters
Section titled “Parameters”| Name | In | Type | Description |
|---|---|---|---|
plan_id | path | string | The plan’s id as GET /subscriptions/plans lists it. |
Response 200
Section titled “Response 200”Returns SubscriptionPlan.
| Field | Type | Description |
|---|---|---|
id | string | The plan’s id, e.g. sub_wax-club_ab12cd. |
name | string or null | Shown in checkout and in the customer’s account. (nullable) |
enabled | boolean | Whether the product page offers the plan. |
products | array of object | |
frequencies | array of object | |
discount | object | |
anchor | object or null | (nullable) |
inventory | object | |
provisioning | object | |
revision | integer | |
created_at | string or null | (nullable) |
updated_at | string or null | (nullable) |
{ "id": "id", "name": "Gold", "enabled": true, "products": [ { "product_id": "8123456789", "variant_ids": [ "variant ids" ] } ], "frequencies": [ { "key": "key", "unit": "DAY", "count": 1, "selling_plan_id": "selling plan id" } ], "discount": { "type": "none", "value": 1, "after_cycle": { "value": 1, "cycle": 1 } }, "anchor": { "type": "WEEKDAY", "day": 1, "cutoff_day": 1 }, "inventory": { "on_out_of_stock": "retry", "retry_attempts": 1, "retry_days": 1, "stop_selling_when_sold_out": false }, "provisioning": { "status": "none", "error": "error", "selling_plan_group_id": "selling plan group id" }, "revision": 1, "created_at": "2026-10-01T09:30:00.000Z", "updated_at": "2026-10-01T09:30:00.000Z"}Example
Section titled “Example”curl -X GET "https://charm.appfleece.app/api/v1/subscriptions/plans/<plan_id>" \ -H "Authorization: Bearer chrm_live_..."Errors
Section titled “Errors”unauthorized · invalid_token · insufficient_scope · access_required · not_found · validation_error · rate_limited
Every error body carries code, message, request_id and a doc_url pointing at the matching entry in the error catalog.