> ## Documentation Index > Fetch the complete documentation index at: https://documentation.qonversion.io/llms.txt > Use this file to discover all available pages before exploring further. # List products > Returns a paginated list of products for the authenticated project. Products are ordered by creation date (newest first). Manifest-compliant: list envelope, string enums, ISO 8601 timestamps. ## OpenAPI ````yaml /api-reference/rest-api-v4.yaml get /products openapi: 3.0.3 info: title: Qonversion REST API v4 version: '4.0' description: >- Qonversion REST API v4 follows REST standards. It has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs. servers: - url: https://api.qonversion.io/v4 description: Production security: - secretAuth: [] tags: - name: Users description: Retrieve Qonversion users - name: User Properties description: Manage user-level attributes - name: Identities description: Link Qonversion users to your own auth IDs - name: Entitlements description: Entitlement definitions and user grants - name: Purchases description: A user's purchase history - name: Products description: Products configured in the Qonversion dashboard - name: Customers description: Aggregated customer records, properties, permissions, and metrics - name: Segments description: Dynamic and system segments of users - name: Experiments description: Paywall and offering A/B experiments - name: Screens description: No-code paywall screens — CRUD, publish, analytics - name: Analytics description: Charts, cards, cohorts, LTV, and insights - name: Exports description: Asynchronous data exports - name: Events description: Event catalog - name: Scheduled Reports description: Recurring reports delivered to external destinations - name: Integrations description: Third-party integrations configuration - name: Automations description: Event-driven automations - name: Project Settings description: Project-level configuration, secret, and store credentials paths: /products: get: tags: - Products summary: List products description: | Returns a paginated list of products for the authenticated project. Products are ordered by creation date (newest first). Manifest-compliant: list envelope, string enums, ISO 8601 timestamps. operationId: v4ListProducts parameters: - name: limit in: query description: Maximum number of products to return. Min 1, max 100. required: false schema: type: integer minimum: 1 maximum: 100 default: 20 - name: starting_after in: query description: > Cursor for pagination. Pass the `id` of the last product from the previous page to fetch the next page. required: false schema: type: string - name: filter[type] in: query description: > Filter products by type. Can be repeated for multiple values (OR logic). required: false schema: type: string x-extensible-enum: - subscription_with_promo - subscription - consumable - lifetime responses: '200': description: A paginated list of products. headers: x-request-id: description: Unique request identifier for tracing. schema: type: string Cache-Control: schema: type: string example: no-cache content: application/json: schema: $ref: '#/components/schemas/V4ProductList' examples: with_results: summary: Page with results value: object: list url: /v4/products data: - object: product id: premium_monthly url: /v4/products/premium_monthly type: subscription duration: P1M apple_product_id: com.example.monthly google_product_id: com.example.monthly google_base_plan_id: monthly-base stripe_product_id: prod_abc123 created_at: '2025-09-15T12:30:00Z' updated_at: '2025-11-03T10:26:40Z' has_more: false empty: summary: Empty collection value: object: list url: /v4/products data: [] has_more: false '400': description: Invalid request parameters. content: application/json: schema: $ref: '#/components/schemas/V4Error' example: error: type: request code: invalid_request message: Parameter 'limit' must be an integer between 1 and 100 '401': description: Missing or invalid authentication token. content: application/json: schema: $ref: '#/components/schemas/V4Error' '403': description: Insufficient permissions. content: application/json: schema: $ref: '#/components/schemas/V4Error' security: - secretAuth: [] components: schemas: V4ProductList: type: object required: - object - url - data - has_more properties: object: type: string enum: - list url: type: string example: /v4/products data: type: array items: $ref: '#/components/schemas/V4Product' has_more: type: boolean next_cursor: type: string description: Present only when has_more is true. V4Error: type: object required: - error properties: error: type: object required: - type - code - message properties: type: type: string enum: - request - resource - logical - internal code: type: string description: | Machine-readable snake_case error code. Examples include `invalid_data`, `invalid_request`, `invalid_product_id`, `not_found`, `already_exists`, `offering_already_exists`, `product_not_in_project`, `cannot_set_main_directly`, `cannot_demote_main`, `cannot_patch_experiment_variant`, `cannot_delete_experiment_variant`, and `cannot_setmain_experiment_variant`. Resource-specific codes are documented on the corresponding reference page. message: type: string description: Human-readable description. May change; do not parse. details: type: array nullable: true description: Per-field validation errors, present on 400 validation failures. items: type: object properties: field: type: string message: type: string V4Product: type: object required: - object - id - url - created_at - updated_at properties: object: type: string enum: - product id: type: string description: Unique product identifier. maxLength: 255 example: premium_monthly url: type: string description: Canonical API path. example: /v4/products/premium_monthly type: type: string nullable: true description: >- Product type (open enum). Values mirror the Qonversion dashboard labels: `subscription_with_promo` (Subscription With Promo Period), `subscription` (Regular Subscription), `consumable`, `lifetime`. x-extensible-enum: - subscription_with_promo - subscription - consumable - lifetime duration: type: string nullable: true description: >- Subscription duration in ISO 8601 period format (open enum). Only products of type `subscription_with_promo` or `subscription` may have a duration; `consumable` and `lifetime` are always null. x-extensible-enum: - P1W - P1M - P3M - P6M - P1Y apple_product_id: type: string nullable: true description: Apple App Store product identifier. google_product_id: type: string nullable: true description: Google Play product identifier. google_base_plan_id: type: string nullable: true description: Google Play base plan identifier. stripe_product_id: type: string nullable: true description: Stripe product identifier. created_at: type: string format: date-time description: Creation timestamp (ISO 8601 UTC). example: '2025-09-15T12:30:00Z' updated_at: type: string format: date-time description: Last update timestamp (ISO 8601 UTC). example: '2025-11-03T10:26:40Z' securitySchemes: secretAuth: type: http scheme: bearer bearerFormat: sk_… description: >- Bearer authentication using the project **Secret Key** (prefixed with `sk_`, or `test_sk_` for sandbox). All v4 public endpoints require the Secret Key — see [Authentication](/reference/v4/authentication). Never expose the Secret Key in client-side code. ````