---
title: "Get Billing Plans"
method: GET
path: "/api/billing/plans"
tags: ["billing"]
---

# Get Billing Plans

`GET /api/billing/plans`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/billing/plans`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

Return the purchasable plan catalog. Public — no auth, no Stripe call.

The catalog is static pricing copy, not workspace billing state, so it stays
reachable without auth. MANAGE_BILLING gates the routes that read or mutate
a workspace's actual subscription.

Pricing/seats/credits live in PLAN_CONFIG; edit there to reconfigure.

## Response `200`

Successful Response

- PlanCatalogResponse
  - `default_plan_tier` 'starter' | 'pro' | 'scale', required: Plan selected when checkout omits an explicit tier.
  - `plans` PlanCatalogEntry[], required: Authoritative purchasable plan catalog.
    - `bundled_seats` integer, required: Connected accounts included by the plan.
    - `credits_limit` integer, required: Credits included in each billing period.
    - `display_name` string, required: Customer-facing plan name.
    - `plan_tier` 'starter' | 'pro' | 'scale', required: Stable purchasable plan tier.
    - `price_cents` integer, required: Monthly plan price in integer US cents.

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)
