list_plans

Paginated list of subscription plans visible to the current token, optionally scoped to one project.

Purpose

List subscription plans. Results are always scoped to the caller's team; pass an optional project_id to narrow further. Ordered by newest-first.

Required ability

project-subscription-plan:view-any

Input schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "description": "Optional project UUID to narrow the list to a single project."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum plans to return per page (1..100)."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "1-indexed page number."
    }
  }
}

Output shape

{
  "data": [
    {
      "id": "pln_01HX...",
      "project_id": "prj_01HX...",
      "name": "Premium Monthly",
      "description": "All-access pass",
      "price": "29.00",
      "currency": "USD",
      "billing_cycle": "months",
      "billing_cycle_count": 1,
      "trial_days": 7,
      "trial_cardless": false,
      "recurring": true,
      "active": true,
      "created_at": "2026-05-18T10:05:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 25,
    "total": 3,
    "has_more": false
  }
}

Example prompts

"List every plan on project prj_01HX...."

"Show me all active plans across my projects."

Failure modes

TOKEN_MISSING_ABILITY — token lacks project-subscription-plan:view-any.