---
title: "Subscription"
method: GET
path: "/workspaces/{workspace_id}/subscription"
tags: ["subscription"]
---

# Subscription

`GET /workspaces/{workspace_id}/subscription`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/workspaces/{workspace_id}/subscription`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/workspaces/:workspace_id/subscription/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns subscription data.

## Path parameters

- `workspace_id` integer, required

## Response `200`

Returns subscription data.

- SubscriptionOutData
  - `auto_renew` boolean
  - `billing_period_in_months` integer
  - `campaign_available` boolean
  - `cancel_date` string
  - `card_details` ModelsCardDetails
    - `added_at` string
    - `card_number` string
    - `card_type` string
    - `creator_id` integer
    - `creator_name` string
    - `expiry_date` string
    - `holder_name` string
  - `company_id` integer
  - `contact_details` ModelsContactDetail
    - `company_address` string
    - `company_city` string
    - `company_name` string
    - `contact_detail_id` integer
    - `contact_email` string
    - `contact_person` string
    - `country_id` integer
    - `country_subdivision_id` integer
    - `created_at` string
    - `customer_id` integer
    - `is_eu_resident` boolean
    - `updated_at` string
    - `user_id` integer
    - `vat_number` string
    - `vat_number_valid` boolean: DEPRECATED
    - `vat_number_validated_at` string: DEPRECATED
    - `zip_code` string
  - `currency` string
  - `current_period_ends_at` string
  - `current_period_starts_at` string
  - `customer_id` integer
  - `end_date` string: Deprecated: this field will be replaced by CurrentPeriodEndsAt
  - `enterprise` boolean
  - `is_subscription_beta` boolean: temporary flag which is true iff there is at least one admin in the organization, who has the `multi_workspace_payments` beta flag enabled
  - `is_unified` boolean
  - `last_invoice` SubscriptionInvoiceInfo
    - `amount` integer
    - `created_at` string
    - `currency_id` integer
    - `due` string
    - `id` integer
    - `paid_at` string
    - `tax_percentage` number
    - `total_amount` integer
  - `last_payment` ModelsPaymentInfo
    - `created_at` string
    - `description` string
    - `id` integer
    - `status` string
  - `last_pricing_plan_id` integer
  - `new_signup_trial` boolean
  - `next_payment_date` string
  - `payment_method` string
  - `plan_name` string
  - `pricing_plan_id` integer: Legacy fields (kept for compatibility with FE)
  - `renewal_at` string
  - `renewal_date` string
  - `seat_cost_in_cents` integer
  - `seats` integer
  - `site` string
  - `start_date` string: Deprecated: this field will be replaced by CurrentPeriodStartsAt
  - `state` string
  - `subscription_created_at` string
  - `subscription_period` ModelsPeriod
    - `created_at` string
    - `finished_on` string
    - `started_on` string
    - `subscription_id` integer
    - `subscription_period_id` integer
    - `trial` boolean
    - `user_count` integer
  - `trial_available` boolean
  - `trial_end_date` string
  - `trial_start_date` string

## Other responses

- `500`: Internal Server Error

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)