# List available billing plans

Returns a list of all visible billing plans with their pricing and features

Endpoint: GET /v1/billing/plans
Version: 1.0.0
Security: bearerAuth

## Response 200 fields (application/json):

  - `plans` (array)

  - `plans.id` (integer, required)
    Unique identifier for the plan
    Example: 1

  - `plans.name` (string, required)
    Display name of the plan
    Example: "Pro"

  - `plans.slug` (string, required)
    URL-friendly identifier for the plan
    Example: "pro"

  - `plans.price` (number, required)
    Price of the plan per user
    Example: 199

  - `plans.price_prefix` (string)
    Currency symbol or prefix for price display
    Example: "$"

  - `plans.price_suffix` (string)
    Suffix for price display (e.g., per month)
    Example: "/user/month"

  - `plans.description` (string)
    Short description of the plan
    Example: "For growing practices"

  - `plans.features` (array)
    List of features included in the plan
    Example: ["Unlimited notes","Priority support","Custom templates"]

## Response 401 fields (application/json):

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (object)
    Detailed validation errors by field
    Example: {"email":["The email must be a valid email address","The email has already been taken"],"password":["The password must be at least 8 characters"],"template_name":["This field is required"]}