---
title: "Plan Details"
method: GET
path: "/api/v1/workspaces/plan_details"
tags: ["Workspace"]
---

# Plan Details

`GET /api/v1/workspaces/plan_details`

Lists details of the workspace's current plan and usage

## Query parameters

- `workspace_id` integer, required — ID of the workspace.

## Response `200`

Successful Response

- PlanDetailsResponse
  - `current_member_count` integer, required — Current number of active workspace members.
  - `current_plan` 'Business' | 'Starter', required — Current workspace plan.
  - `current_plan_status` 'Active' | 'Downgraded' | 'Cancelled' | 'NeverSubscribed', required — Current workspace plan status.
  - `downgrade_at` string, nullable, required — Date when the workspace downgrades, or `null` if not scheduled.
  - `current_active_projects` integer, required — Current number of active workspace projects.
  - `maximum_active_projects` integer, required — Maximum number of active projects allowed by the plan.
  - `price_list` FormattedPriceListing[], required — Available plan prices for the workspace country.
    - `billing_cycle` 'monthly' | 'yearly', required — Billing cycle for the listed prices.
    - `prices` FormattedPrice[], required — Prices available for the billing cycle.
      - `currency` string, required — ISO 4217 currency code.
      - `unit_amount` integer, required — Price amount in the currency's smallest unit.
      - `tax_behavior` string, required — Tax behavior for the price.
  - `workspace_id` integer, required — ID of the workspace.
  - `is_trialing` boolean, required — Whether the workspace is currently trialing a paid plan.
  - `trial_ends_at` string, nullable, required — Date when the current trial ends, or `null` if not trialing.
  - `cancel_at_period_end` boolean, required — Whether the plan cancels at the end of the billing period.
  - `has_trialed` boolean, required — Whether the workspace has already used a trial.
  - `plan_price` PlanPrice, required
    - `amount` string, required — Formatted plan price amount.
    - `raw_amount` number, required — Raw plan price amount in the currency's smallest unit.
    - `currency` string, required — ISO 4217 currency code.
    - `billing_cycle` 'monthly' | 'yearly', nullable, required — Billing cycle for the plan price, or `null` if unknown.
    - `tax_behavior` 'exclusive' | 'inclusive' | 'unspecified', required — Tax behavior for the plan price.
  - `has_billing_portal` boolean, required — Whether a billing portal is available for the workspace.
  - `has_billing_portal_switch_to_annual` boolean, required — Whether the billing portal can switch the subscription to annual billing.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/todoist/apis/todoist-api.md) · [All operations](https://skmtc.net/todoist/apis/todoist-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/todoist/todoist-api/revisions/69a962f1578f/schema)