---
title: "Get workspace subscription"
method: GET
path: "/v1/billing/subscription"
tags: ["Billing"]
---

# Get workspace subscription

`GET /v1/billing/subscription`

## Query parameters

- `workspace_id` string, required

## Response `200`

Current subscription (or null)

- object
  - `subscription` Subscription
    - `id` string
    - `workspace_id` string
    - `plan_id` string
    - `status` 'trialing' | 'active' | 'past_due' | 'cancelled' | 'expired'
    - `seats` integer
    - `pending_seats` integer, nullable
    - `pending_plan_id` string, nullable
    - `is_complimentary` boolean
    - `trial_ends_at` string, date-time, nullable
    - `current_period_end` string, date-time, nullable
    - `plan` BillingPlan
      - `id` string
      - `name` string
      - `tier` 'pro' | 'teams'
      - `interval` 'monthly' | 'annual'
      - `price_cents` integer
      - `min_seats` integer

---

[API](https://skmtc.net/shareout/apis/shareout-rest-api.md) · [All operations](https://skmtc.net/shareout/apis/shareout-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shareout/shareout-rest-api/versions/804359ead65a/schema)