> ## Documentation Index > Fetch the complete documentation index at: https://commet.co/docs/llms.txt > Use this file to discover all available pages before exploring further. # List plan versions > List a plan's published versions, newest first, with their prices and how many subscriptions are on each. Versions published before Commet recorded every term are not listed. List a plan's published versions, newest first, with their prices and how many subscriptions are on each. Versions published before Commet recorded every term are not listed. ## OpenAPI ````yaml /openapi/es/rest/2026-08-27.json get /plans/{id}/versions openapi: 3.1.0 info: title: Commet API version: '2026-08-27' description: Billing and payments API for SaaS and AI products. servers: - url: https://commet.co/api/v1 security: - ApiKeyAuth: [] tags: - name: Test Clock description: >- Simulate the passage of time in sandbox to test billing flows. Mirrors Stripe test clocks: forward-only and sandbox-only. - name: Customers - name: Subscriptions - name: Plans - name: Markets description: >- Reusable country groups for market-specific prices and selectable price variants. - name: Offers - name: Promo Codes - name: Features - name: Usage - name: Seats - name: Quota - name: Add-ons - name: Portal - name: Credit Packs - name: Plan Groups - name: Invoices - name: Payments description: >- One-time payments with no subscription or plan. Charge a customer's saved payment method off-session, or create a payment link the customer opens to pay. Tax, invoice, and receipt are handled automatically. - name: Transactions - name: Webhooks - name: API Keys - name: Payouts description: >- Withdraw available balance to your bank and manage the payout account (verification + destination bank accounts). - name: Provisioning description: >- Take ownership of an organization an agent provisioned headlessly. The agent holds the API keys from the start; a human claims the account through a claim link. paths: /plans/{id}/versions: get: tags: - Plans summary: List plan versions description: >- List a plan's published versions, newest first, with their prices and how many subscriptions are on each. Versions published before Commet recorded every term are not listed. operationId: list-plan-versions parameters: - name: id in: path required: true schema: type: string - name: cursor in: query required: false schema: type: string minLength: 1 - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 100 - name: Commet-Version in: header required: false description: >- API version used by this reference. Send this header to select this contract explicitly. schema: type: string default: '2026-08-27' example: '2026-08-27' responses: '200': description: Success headers: X-Request-Id: $ref: '#/components/headers/RequestId' RateLimit-Limit: description: Maximum number of requests allowed in the current window. schema: type: string RateLimit-Remaining: description: Requests remaining in the current window. schema: type: string content: application/json: schema: type: object properties: object: type: string const: list data: type: array items: $ref: '#/components/schemas/PlanVersion' hasMore: type: boolean nextCursor: type: string required: - object - data - hasMore additionalProperties: false example: object: list data: - id: plr_9i0j1k2l label: '4' number: 4 experiment: null isCurrent: true parentVersionId: plr_5e6f7g8h subscriptionCount: 0 maxPlanCredits: null maxPlanBalance: null prices: - id: pp_1a2b3c4d billingInterval: monthly price: 5500 includedCredits: null includedBalance: 5000 regionalPrices: - currency: mxn price: 99900 includedBalance: null createdAt: '2026-09-07T12:00:00.000Z' object: plan_version - id: plr_1a2b3c4d label: price-test 2 number: null experiment: code: pro:price-test version: 2 isCurrent: false parentVersionId: plr_5e6f7g8h subscriptionCount: 4 maxPlanCredits: null maxPlanBalance: null prices: - id: pp_1a2b3c4d billingInterval: monthly price: 5500 includedCredits: null includedBalance: 5000 regionalPrices: - currency: mxn price: 99900 includedBalance: null createdAt: '2026-09-07T12:00:00.000Z' object: plan_version hasMore: false '400': description: Bad request headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: validation_error code: validation_error message: The request contains an invalid parameter. doc_url: >- https://commet.co/docs/api-reference/2026-08-27/errors/validation_error.md '401': description: Unauthorized headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: authentication_error code: unauthorized message: A valid API key is required. doc_url: >- https://commet.co/docs/api-reference/2026-08-27/errors/unauthorized.md '403': description: Forbidden headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: authentication_error code: forbidden message: You do not have permission to perform this operation. doc_url: >- https://commet.co/docs/api-reference/2026-08-27/errors/forbidden.md '404': description: Not found headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: not_found_error code: not_found message: The requested resource was not found. doc_url: >- https://commet.co/docs/api-reference/2026-08-27/errors/not_found.md '429': description: Too many requests headers: X-Request-Id: $ref: '#/components/headers/RequestId' RateLimit-Limit: description: Maximum number of requests allowed in the current window. schema: type: string RateLimit-Remaining: description: Requests remaining in the current window. schema: type: string RateLimit-Reset: description: Seconds until the rate limit window resets. schema: type: string Retry-After: description: Seconds to wait before retrying the request. schema: type: string content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: rate_limit_error code: rate_limited message: >- Too many requests. Retry after the interval specified in the Retry-After header. doc_url: >- https://commet.co/docs/api-reference/2026-08-27/errors/rate_limited.md '500': description: Internal server error headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: internal_error code: internal_error message: An unexpected error occurred while processing the request. doc_url: >- https://commet.co/docs/api-reference/2026-08-27/errors/internal_error.md components: headers: RequestId: description: >- Server-generated identifier that correlates this response with Platform logs. schema: type: string format: uuid schemas: PlanVersion: type: object properties: id: type: string description: Public plan version ID. label: type: string description: >- The plan's versions are numbered 1, 2, 3; an experiment's own versions read with its code, such as price-test 2. number: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- The plan's version number. Null for a version that only belongs to an experiment; an experiment version made current takes the next number. experiment: anyOf: - type: object properties: code: type: string description: The experiment's code, as sold with planCode. version: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Its number within the experiment. required: - code - version additionalProperties: false - type: 'null' description: The experiment this version belongs to, if any. isCurrent: type: boolean description: Whether new buyers get this version. parentVersionId: description: The version this one was created from. type: - string - 'null' subscriptionCount: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Active, trialing, past due and paused subscriptions on it. maxPlanCredits: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' maxPlanBalance: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' prices: type: array items: type: object properties: id: type: string description: Public plan price ID. billingInterval: type: string enum: - weekly - monthly - quarterly - semiannual - yearly - one_time price: type: integer minimum: -9007199254740991 maximum: 9007199254740991 includedCredits: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' includedBalance: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' regionalPrices: type: array items: type: object properties: currency: type: string price: type: integer minimum: -9007199254740991 maximum: 9007199254740991 includedBalance: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' required: - currency - price - includedBalance additionalProperties: false required: - id - billingInterval - price - includedCredits - includedBalance - regionalPrices additionalProperties: false createdAt: type: string format: date-time object: type: string const: plan_version livemode: type: boolean required: - id - label - number - experiment - isCurrent - parentVersionId - subscriptionCount - maxPlanCredits - maxPlanBalance - prices - createdAt - object - livemode additionalProperties: false ErrorResponse: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string param: type: string details: {} doc_url: type: string required: - type - code - message - doc_url additionalProperties: false required: - error additionalProperties: false securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.