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

# List all products

> Retrieve a paginated list of products for the store identified by `x-store-id`. Supports filtering by `status` and `pricing_model`, as well as pagination using `limit`, `page`, and `offset`. Returns detailed product information including variants and images.



## OpenAPI

````yaml /api-reference/blink-api.json get /v1/products
openapi: 3.0.0
info:
  title: Blink API
  description: Comprehensive API documentation for Blink.
  version: 1.0.0
servers:
  - url: https://api.blink.store/v1
security:
  - storeIdHeader: []
tags:
  - name: Invoices
    description: Unified merchant of record invoices for products and subscriptions.
  - name: Geo Pricing
    description: Resolve Purchasing Power Parity (PPP) localized pricing.
paths:
  /v1/products:
    get:
      tags:
        - Products
      summary: List all products
      description: >-
        Retrieve a paginated list of products for the store identified by
        `x-store-id`. Supports filtering by `status` and `pricing_model`, as
        well as pagination using `limit`, `page`, and `offset`. Returns detailed
        product information including variants and images.
      parameters:
        - name: status
          in: query
          description: Filter products by status.
          schema:
            type: string
        - name: pricing_model
          in: query
          description: Filter products by pricing model.
          schema:
            type: string
        - name: limit
          in: query
          schema:
            type: integer
          description: Maximum number of products to return.
        - name: page
          in: query
          schema:
            type: integer
          description: Page number to retrieve.
      responses:
        '200':
          description: List of products retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductsList'
        '401':
          description: Unauthorized - Store ID header missing.
        '500':
          description: Internal Server Error.
      security:
        - storeIdHeader: []
components:
  schemas:
    ProductsList:
      type: object
      properties:
        meta:
          type: object
          properties:
            total:
              type: integer
            page:
              type: integer
            limit:
              type: integer
            has_more:
              type: boolean
        data:
          type: array
          items:
            $ref: '#/components/schemas/ProductDetails'
    ProductDetails:
      type: object
      properties:
        id:
          type: string
        store_id:
          type: string
        name:
          type: string
        description:
          type: string
        preview_link:
          type: string
        pricing_model:
          type: string
        price:
          type: number
        currency:
          type: string
        status:
          type: string
        created_at:
          type: string
          format: date-time
        subscription_interval:
          type: string
        trial_days:
          type: integer
        pricing_tiers:
          type: string
        package_size:
          type: integer
        metered_prices:
          type: string
        requires_license_key:
          type: boolean
        license_key_activation_limit:
          type: integer
        cart_recovery_enabled:
          type: boolean
        customer_portal_visibility:
          type: boolean
        variants:
          type: array
          items:
            $ref: '#/components/schemas/ProductVariantDetails'
        deliverables:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              type:
                type: string
              title:
                type: string
              description:
                type: string
              url:
                type: string
              button_label:
                type: string
              created_at:
                type: string
                format: date-time
        images:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              file_url:
                type: string
              position:
                type: integer
    ProductVariantDetails:
      type: object
      properties:
        id:
          type: string
        product_id:
          type: string
        name:
          type: string
        description:
          type: string
        price:
          type: number
        subscription_interval:
          type: string
        trial_days:
          type: integer
        is_active:
          type: boolean
        requires_license_key:
          type: boolean
        license_key_activation_limit:
          type: integer
        created_at:
          type: string
          format: date-time
        deliverables:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              type:
                type: string
              title:
                type: string
              description:
                type: string
              url:
                type: string
              button_label:
                type: string
              created_at:
                type: string
                format: date-time
  securitySchemes:
    storeIdHeader:
      type: apiKey
      in: header
      name: x-store-id

````