> ## Documentation Index > Fetch the complete documentation index at: https://docs.whop.com/llms.txt > Use this file to discover all available pages before exploring further. # List Plans > Returns a paginated list of plans belonging to an account, with optional filtering by visibility, type, release method, and product. ## OpenAPI ````yaml /openapi/api-v1-native.yml get /plans openapi: 3.1.0 info: title: Whop API description: >- Hand-written V1 endpoints. Merged into the GraphqlRestProxy-generated schema at build time. version: v1 servers: - url: https://{defaultHost} variables: defaultHost: default: api.whop.com/api/v1 security: [] paths: /plans: parameters: - $ref: '#/components/parameters/ApiVersionDate' get: tags: - Plans summary: List Plans description: >- Returns a paginated list of plans belonging to an account, with optional filtering by visibility, type, release method, and product. operationId: listPlans parameters: - name: account_id in: query schema: type: string required: true description: The unique identifier of the account to list plans for. - name: direction in: query schema: type: string enum: - asc - desc required: false description: The sort direction for results. Defaults to descending. - name: order in: query schema: type: string enum: - id - active_members_count - created_at - internal_notes - expires_at required: false description: The field to sort results by. Defaults to created_at. - name: release_methods in: query schema: type: array items: type: string required: false description: Filter to only plans matching these release methods. - name: visibilities in: query schema: type: array items: type: string required: false description: Filter to only plans matching these visibility states. - name: plan_types in: query schema: type: array items: type: string required: false description: Filter to only plans matching these billing types. - name: product_ids in: query schema: type: array items: type: string required: false description: Filter to only plans belonging to these product identifiers. - name: created_before in: query schema: type: string required: false description: Only return plans created before this timestamp. - name: created_after in: query schema: type: string required: false description: Only return plans created after this timestamp. - name: first in: query schema: type: integer required: false description: The number of plans to return (default and max 100). - name: after in: query schema: type: string required: false description: A cursor; returns plans after this position. - name: last in: query schema: type: integer required: false description: The number of plans to return from the end of the range. - name: before in: query schema: type: string required: false description: A cursor; returns plans before this position. responses: '200': description: plans listed content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/PlanListItem' page_info: type: object properties: end_cursor: type: - string - 'null' start_cursor: type: - string - 'null' has_next_page: type: boolean has_previous_page: type: boolean required: - end_cursor - start_cursor - has_next_page - has_previous_page required: - data - page_info '400': $ref: '#/components/responses/InvalidParameters' description: missing account_id '401': $ref: '#/components/responses/Unauthorized' description: missing or invalid authentication security: - bearerAuth: - plan:basic:read components: parameters: ApiVersionDate: name: Api-Version-Date in: header required: false schema: type: string format: date example: '2026-06-20' description: >- Pins the request to a dated API version. When omitted, the request uses the original (2025-01-01) request/response shapes, so existing unversioned callers are never broken. Generated SDKs always send the latest version they were built against. An unrecognized value is rejected with a 400. The schemas documented here always describe the latest version. schemas: PlanListItem: type: object properties: id: type: string description: Plan ID, prefixed `plan_`. created_at: type: string description: When the plan was created, as an ISO 8601 timestamp. updated_at: type: string description: When the plan was last updated, as an ISO 8601 timestamp. visibility: type: string description: Whether the plan is visible to customers or hidden from public view. plan_type: type: string description: >- Billing model for this plan: `renewal` (recurring) or `one_time` (single payment). release_method: type: string description: Sales method for this plan, such as `buy_now` or `waitlist`. currency: type: string description: Three-letter ISO currency code for this plan's prices. account: type: - object - 'null' description: Account that sells this plan; `null` for standalone invoice plans. product: type: - object - 'null' description: Product this plan belongs to; `null` for standalone plans. invoice: type: - object - 'null' description: >- Invoice this plan was generated for; `null` unless created for an invoice. billing_period: type: - number - 'null' description: >- Recurring billing interval in days, such as 30 for monthly or 365 for annual. `null` for one-time plans. title: type: - string - 'null' description: Plan display name shown to customers. description: type: - string - 'null' description: Customer-visible plan description. purchase_url: type: string description: URL where customers can purchase this plan directly. expiration_days: type: - number - 'null' description: Access duration in days for expiration-based plans. initial_price: type: number description: Initial purchase price in plan currency. renewal_price: type: number description: Recurring price charged every billing period. trial_period_days: type: - number - 'null' description: >- Free trial days before the first renewal charge. `null` if no trial is configured or the user has already used a trial for this plan. three_ds_level: type: - string - 'null' description: 3D Secure behavior for this plan; `null` inherits account default. member_count: type: - number - 'null' description: Active memberships through this plan, when visible to the requester. internal_notes: type: - string - 'null' description: Private notes visible only to authorized team members. metadata: type: - object - 'null' description: Custom key-value pairs stored on the plan. stock: type: - number - 'null' description: Units available for purchase, when visible to the requester. unlimited_stock: type: boolean description: Whether the plan has unlimited stock. split_pay_required_payments: type: - number - 'null' description: Installment payments required before the subscription pauses. adaptive_pricing_enabled: type: boolean description: >- Whether this plan accepts local currency payments via adaptive pricing. payment_method_configuration: type: - object - 'null' description: >- Payment method configuration (`enabled`, `disabled`, `include_platform_defaults`); `null` when plan uses default settings. required: - id - created_at - updated_at - visibility - plan_type - release_method - currency - account - product - invoice - billing_period - title - description - purchase_url - expiration_days - initial_price - renewal_price - trial_period_days - three_ds_level - member_count - internal_notes - metadata - stock - unlimited_stock - split_pay_required_payments - adaptive_pricing_enabled - payment_method_configuration V1ErrorResponse: type: object properties: error: type: object properties: type: type: string description: Machine-readable error code. message: type: string description: Human-readable error message. required: - type - message required: - error responses: InvalidParameters: description: Invalid Parameters content: application/json: schema: $ref: '#/components/schemas/V1ErrorResponse' Unauthorized: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/V1ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: auth-scheme description: >- An account API key, account scoped JWT, app API key, or user OAuth token. ````