---
title: "List billing plans"
method: GET
path: "/api/v1/billing/plans"
tags: ["billing"]
---

# List billing plans

`GET /api/v1/billing/plans`

## Request

- Base URL: `https://api.cadencz.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cadencz.com/api/v1/billing/plans`
- Auth: none declared

Returns the Dodo Payments subscription catalog and allowance definitions for the frontend.

## Response `200`

Successful Response

- BillingPlansResponse
  - `plans` BillingPlan[], required
    - `tier` string, required
    - `name` string, required
    - `section` string, required
    - `badge` string, required
    - `support_label` string, required
    - `purchasable` boolean, required
    - `price_monthly_usd_cents` integer, required
    - `price_yearly_usd_cents` integer, required
    - `annual_discount_percent` integer, required
    - `included_credits` integer, required
    - `channel_cap` integer, required
    - `x_account_cap` integer, required
    - `platform_account_caps` object
    - `premium_action_cap` integer, required
    - `plan_run_cap` integer, required
    - `posts_per_plan_cap` integer, required
    - `posts_per_write_cap` integer
    - `total_ai_generation_cap` integer, required
    - `non_x_scheduled_post_cap` integer, nullable, required
    - `seat_cap` integer, required
    - `workspace_cap` integer, required
    - `ai_analytics_insight_cap` integer, required
    - `automation_rule_cap` integer, required
    - `x_posts_per_month_cap` integer, required
    - `x_link_post_allowance_units` integer, required
    - `x_analytics` boolean, required
    - `x_analytics_snapshots_per_post` integer, required
    - `analytics_history_days` integer, nullable, required
    - `analytics_refresh_interval_minutes` integer, required
    - `brain_cap` integer, required
    - `brain_analysis_cap` integer, required
    - `brain_analysis_page_cap` integer, required
    - `lifetime_allowances` boolean, required
    - `max_model_tier` string, required
    - `critic_enabled` boolean, required
    - `refine_enabled` boolean, required
    - `mcp_enabled` boolean, required
    - `dodo_product_id` string, nullable, required
    - `dodo_yearly_product_id` string, nullable, required
  - `topups` TopUpOption[], required
    - `credits` integer, required
    - `price_usd` integer, required
    - `dodo_product_id` string, nullable, required
  - `provider` 'dodo', required
  - `mode` 'test' | 'live', required
  - `action_costs` object

---

[API](https://skmtc.dev/cadencz/apis/cadencz-api.md) · [All operations](https://skmtc.dev/cadencz/apis/cadencz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cadencz/apis/cadencz-api/revisions/3392fe5e93db?raw)