---
title: "Get User Plan"
method: GET
path: "/api/v1/subscriptions/plan"
tags: ["User APIs", "subscriptions"]
---

# Get User Plan

`GET /api/v1/subscriptions/plan`

Get all active subscription plans for the current user's client.

Returns all subscriptions with active status (active/trialing/past_due).
If no active subscriptions exist, returns an empty list.

All data is sourced from:
- StripeSubscription model columns
- meta_data field (custom Stripe metadata)
- raw field (full Stripe subscription object)
- daily_token_limit column

Returns:
    List[ClientPlanDetails]: List of all active subscription plans for the client

## Response `200`

Successful Response

- ClientPlanDetails[]
  - `id` string, required
  - `slug` string, required
  - `client_id` string, uuid, required
  - `description` string, nullable
  - `notes` string, nullable
  - `platform_fee` number, nullable
  - `client_admin_email` string, nullable
  - `client_admin_name` string, nullable
  - `platform_fee_schedule` string, nullable
  - `payment_method` string, nullable
  - `plan_start_date` string, date-time, nullable
  - `free_tokens_amount` number, nullable
  - `free_tokens_duration_count` integer, nullable
  - `free_tokens_duration` string, nullable
  - `daily_token_limit` number, nullable
  - `is_mcp_plan` boolean
  - `plan_type` string
  - `setup_payment_on_behalf_of_the_client` boolean
  - `billing_cycle_limit` integer, nullable
  - `auto_renew` boolean
  - `disable_invoice_as_payment_method` boolean
  - `invoice_payment` boolean
  - `is_active` boolean
  - `plan_name` string, nullable
  - `product_name` string, nullable
  - `subscription_id` string, required
  - `status` string, required
  - `current_period_start` string, date-time, nullable
  - `current_period_end` string, date-time, nullable
  - `cancel_at` string, date-time, nullable
  - `canceled_at` string, date-time, nullable
  - `trial_end` string, date-time, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `extra_data` object, nullable

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)