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

# List Plans

`GET /api/v1/subscription-plans/`

## Request

- Base URL: `https://api.gnosari.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gnosari.com/api/v1/subscription-plans/`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-AUTH-TOKEN`

List all subscription plans (public endpoint).

Query Parameters:
- skip: Number of records to skip (pagination)
- limit: Maximum number of records to return
- active_only: Filter to only active plans (default: true)

Returns:
- List of plans with full feature details

## Query parameters

- `skip` integer
- `limit` integer
- `active_only` boolean

## Response `200`

Successful Response

- SubscriptionPlan[]
  - `name` string, required: Plan display name
  - `identifier` string, required: Unique plan identifier
  - `description` string, nullable: Plan description
  - `billing_interval` 'month' | 'year', required: Billing interval enum.
  - `price` integer, required: Price in cents
  - `currency` string: ISO currency code
  - `active` boolean: Whether plan is available for new subscriptions
  - `id` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `features` SubscriptionPlanFeatures: Schema for plan features in database.
    - `max_agents` integer, nullable: Maximum agents (-1 or None = unlimited)
    - `max_teams` integer, nullable: Maximum teams
    - `max_sessions_per_month` integer, nullable: Monthly session limit
    - `max_knowledge_sources` integer, nullable: Maximum knowledge sources
    - `max_tools` integer, nullable: Maximum custom tools
    - `max_api_calls_per_month` integer, nullable: Monthly API call limit
    - `max_storage_mb` integer, nullable: Storage limit in MB
    - `max_team_members` integer, nullable: Maximum team members
    - `advanced_analytics` boolean: Access to advanced analytics
    - `priority_support` boolean: Priority customer support
    - `custom_branding` boolean: Custom branding options
    - `api_access` boolean: API access enabled
    - `sso_enabled` boolean: SSO authentication enabled
    - `dedicated_infrastructure` boolean: Dedicated infrastructure
    - `id` integer, required
    - `plan_id` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

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