---
title: "Get Current Subscription"
method: GET
path: "/billing/subscription"
tags: ["billing"]
---

# Get Current Subscription

`GET /billing/subscription`

## Request

- Base URL: `https://api.threadchain.pro` (the document declares no server; this is the origin it was published from)
- URL: `https://api.threadchain.pro/billing/subscription`
- Auth: OAuth 2
  - Password
  - Token URL: `auth/token`

Get current user's active subscription.

## Response `200`

Successful Response

- SubscriptionResponse: Response schema for subscription details
  - `id` string, uuid, required
  - `user_id` string, uuid, required
  - `payment_plan_id` string, uuid, required
  - `status` string, required
  - `current_period_start` string, date-time, required
  - `current_period_end` string, date-time, required
  - `cancel_at_period_end` boolean, required
  - `cancelled_at` string, date-time, nullable, required
  - `tech_packs_used_this_period` integer, required
  - `image_credits_used_this_period` integer, required
  - `stripe_subscription_id` string, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable
  - `payment_plan` PaymentPlanResponse, required: Response schema for payment plan details
    - `id` string, uuid, required
    - `name` string, required
    - `slug` string, required
    - `description` string, nullable, required
    - `price_gbp` string, required
    - `price_usd` string, nullable
    - `price_eur` string, nullable
    - `standard_price_gbp` string, nullable
    - `standard_price_usd` string, nullable
    - `standard_price_eur` string, nullable
    - `currency` string, required
    - `billing_period` string, required
    - `features` string[], required
    - `tech_pack_quota` integer, nullable, required
    - `additional_tech_pack_price` string, nullable, required
    - `image_credits_per_month` integer, nullable, required
    - `quota_limits` object, nullable
    - `is_active` boolean, required
    - `is_public` boolean, required
    - `created_at` string, date-time, required
    - `feature_flags` object
    - `is_recommended` boolean
    - `savings_percent` integer, nullable
    - `trial_duration_days` integer
    - `seats_max` integer
  - `is_trial_eligible` boolean
  - `next_invoice_amount` string, nullable
  - `next_invoice_currency` string, nullable
  - `seats_max` integer, nullable
  - `scheduled_plan_id` string, uuid, nullable
  - `scheduled_plan_slug` string, nullable
  - `scheduled_plan_name` string, nullable
  - `scheduled_change_at` string, date-time, nullable

---

[API](https://skmtc.dev/threadchain/apis/threadchain-backend.md) - [All operations](https://skmtc.dev/threadchain/apis/threadchain-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/threadchain/apis/threadchain-backend/revisions/8ee288a7e6bd?raw)