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

# List active billing plans

`GET /v1/plans`

## Request

- Base URL: `https://api.wavehouse.cloud`
- URL: `https://api.wavehouse.cloud/v1/plans`
- Auth: one of:
  - API key in cookie `whc_session`
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `limit` integer: page size; 0 or absent means 50
- `cursor` string: next_cursor from the previous page; absent for the first page

## Response `200`

OK

- PlanPage
  - `data` PlanView[], required
    - `active` boolean, required
    - `allowances` PlanAllowanceView[], required
      - `display_name` string, required
      - `included` integer, required
      - `metric` string, required
      - `price_unit` string
      - `unit` string, required
      - `unit_price_micros` integer, required
    - `created_at` string, date-time, required
    - `currency` string, required: ISO 4217
    - `limits` PlanLimitsView, required
      - `extra_project_price_micros` integer, required
      - `members_limit` integer, required
      - `projects_included` integer, required
      - `tables_per_project` integer, required
    - `monthly_price_micros` integer, required
    - `name` string, required
    - `over_limit_behavior` string
    - `plan_id` string, required
    - `tier` string, required
  - `next_cursor` string, nullable, required: pass as cursor to fetch the next page; null on the last page

## Other responses

- `429`: Rate limited, per client IP, API key or org; a client IP is also refused on every route for a while after repeated authentication failures. A limited operation carries RateLimit-Policy and RateLimit on every response; wait Retry-After seconds before retrying.
- `default`: Error

---

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