> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creem.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List the price versions of a product

> List every price version of a product, newest first, with how many running subscriptions sit on each. A price change creates a new version; running subscriptions stay on the version they bought. Archived products can be read too.



## OpenAPI

````yaml get /v1/products/{id}/prices
openapi: 3.0.0
info:
  title: Creem API
  description: >-
    Creem is an all-in-one platform for managing subscriptions and recurring
    revenue, tailored specifically for today's SaaS companies. It enables you to
    boost revenue, enhance customer retention, and scale your operations
    seamlessly.
  version: v1
  contact:
    name: Creem Support
    url: https://creem.io
    email: support@creem.io
  license:
    name: Commercial
    url: https://creem.io/terms
  termsOfService: https://creem.io/terms
servers:
  - url: https://api.creem.io
    description: Production — live API for processing real transactions and data.
    x-speakeasy-server-id: prod
  - url: https://test-api.creem.io
    description: Test — sandbox API for development and testing with no real charges.
    x-speakeasy-server-id: test
security: []
tags: []
externalDocs:
  description: Creem Documentation
  url: https://docs.creem.io
paths:
  /v1/products/{id}/prices:
    get:
      tags:
        - Products
      summary: List the price versions of a product
      description: >-
        List every price version of a product, newest first, with how many
        running subscriptions sit on each. A price change creates a new version;
        running subscriptions stay on the version they bought. Archived products
        can be read too.
      operationId: listProductPrices
      parameters:
        - name: id
          required: true
          in: path
          description: The product ID
          schema:
            type: string
      responses:
        '200':
          description: Successfully retrieved the price versions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductPriceVersionListEntity'
        '400':
          description: Bad Request - Invalid input parameters
        '401':
          description: Unauthorized - Invalid or missing API key
        '404':
          description: Not Found - Resource does not exist
      security:
        - ApiKey: []
components:
  schemas:
    ProductPriceVersionListEntity:
      type: object
      properties:
        items:
          description: >-
            Every price version, newest first. Empty for a legacy product with
            no price rows. Usage prices are unversioned and not listed.
          type: array
          items:
            $ref: '#/components/schemas/ProductPriceVersionEntity'
        subscriptions_without_price_version:
          description: Running subscriptions not billed on any listed version.
          allOf:
            - $ref: '#/components/schemas/RunningSubscriptionCountsEntity'
      required:
        - items
        - subscriptions_without_price_version
    ProductPriceVersionEntity:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of the price version.
          example: pprice_abc
        price:
          type: number
          description: The price of this version in cents. 1000 = $10.00
          example: 2900
        currency:
          type: string
          description: Three-letter ISO currency code, in uppercase.
          example: EUR
        billing_type:
          $ref: '#/components/schemas/ProductBillingType'
        billing_period:
          $ref: '#/components/schemas/ProductBillingPeriod'
        recurring_interval:
          type: string
          description: >-
            Unit of the billing interval (`day`, `week`, `month` or `year`).
            `null` for a one-time version.
          nullable: true
        recurring_interval_count:
          type: integer
          description: >-
            Number of `recurring_interval` units per billing cycle. `null` for a
            one-time version.
          nullable: true
        pricing_model:
          $ref: '#/components/schemas/ProductPriceVersionPricingModel'
        created_at:
          format: date-time
          type: string
          description: When this version was created.
          example: '2023-01-01T00:00:00Z'
        current:
          type: boolean
          description: >-
            Whether new purchases get it. True on exactly one version in a
            non-empty list.
        subscriptions:
          description: >-
            Running subscriptions billed on this version. One with items on
            several versions counts on each.
          allOf:
            - $ref: '#/components/schemas/RunningSubscriptionCountsEntity'
      required:
        - id
        - price
        - currency
        - billing_type
        - billing_period
        - recurring_interval
        - recurring_interval_count
        - pricing_model
        - created_at
        - current
        - subscriptions
    RunningSubscriptionCountsEntity:
      type: object
      properties:
        total:
          type: number
          description: >-
            Running subscriptions. Canceled, expired, incomplete and error ones
            are not counted.
        by_status:
          description: Per status; all six are always present.
          allOf:
            - $ref: '#/components/schemas/RunningSubscriptionStatusCountsEntity'
      required:
        - total
        - by_status
    ProductBillingType:
      type: string
      description: >-
        Indicates the billing method for the customer. It can either be a
        `recurring` billing cycle or a `onetime` payment.
      enum:
        - recurring
        - onetime
    ProductBillingPeriod:
      type: string
      description: Billing period
      enum:
        - every-month
        - every-three-months
        - every-six-months
        - every-year
        - every-day
        - once
        - custom
    ProductPriceVersionPricingModel:
      type: string
      description: How this version is priced.
      enum:
        - standard
        - package
        - usage_based
    RunningSubscriptionStatusCountsEntity:
      type: object
      properties:
        active:
          type: number
          description: Subscriptions in status `active`.
          example: 9
        trialing:
          type: number
          description: Subscriptions in status `trialing`.
          example: 1
        past_due:
          type: number
          description: Subscriptions in status `past_due`.
          example: 1
        scheduled_cancel:
          type: number
          description: Subscriptions in status `scheduled_cancel`.
          example: 0
        paused:
          type: number
          description: Subscriptions in status `paused`.
          example: 1
        unpaid:
          type: number
          description: Subscriptions in status `unpaid`.
          example: 0
      required:
        - active
        - trialing
        - past_due
        - scheduled_cancel
        - paused
        - unpaid
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key for authentication. You can find your API key in the Creem
        dashboard under Settings > API Keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.