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

# List products

> Developer API operation for GET /dev/v1/products.



## OpenAPI

````yaml /openapi.json get /dev/v1/products
openapi: 3.0.3
info:
  title: Shoppex Developer API
  description: Mintlify-compatible Developer API reference for Shoppex.
  version: 1.0.0
  contact:
    name: Shoppex Support
    email: support@shoppex.io
    url: https://shoppex.io
servers:
  - url: https://api.shoppex.io
security:
  - bearerAuth: []
paths:
  /dev/v1/products:
    get:
      tags:
        - Products
      summary: List products
      description: Developer API operation for GET /dev/v1/products.
      operationId: getDevV1Products
      parameters:
        - name: cursor
          in: query
          required: false
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            type: string
        - name: include_stats
          in: query
          required: false
          schema:
            type: string
        - name: include_variants
          in: query
          required: false
          schema:
            type: string
        - name: locale
          in: query
          required: false
          schema:
            description: Locale for translated catalog content.
            type: string
      responses:
        '200':
          description: Response for status 200
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - pagination
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      required:
                        - additional_role_ids
                        - discord_required_role_id
                        - discord_server_id
                        - license_period
                      properties:
                        additional_role_ids:
                          type: array
                          description: Additional Discord role ids (max 20).
                          items:
                            type: string
                        discord_required_role_id:
                          type: string
                          nullable: true
                        discord_server_id:
                          type: string
                          nullable: true
                        license_period:
                          nullable: true
                          anyOf:
                            - type: string
                            - type: number
                        license_mode:
                          type: string
                          enum:
                            - LIFETIME
                            - PERIOD
                            - INHERIT
                        license_period_days:
                          type: number
                          nullable: true
                      additionalProperties: true
                  pagination:
                    type: object
                    required:
                      - next_cursor
                      - has_more
                    properties:
                      next_cursor:
                        type: string
                        nullable: true
                      has_more:
                        type: boolean
                additionalProperties: true
                example:
                  data:
                    - id: prod_db_1
                      uniqid: prod_1
                      shop_id: shop_1
                      slug: starter-pack
                      type: DYNAMIC
                      subtype: null
                      title: Starter Pack
                      currency: USD
                      price: 19.99
                      price_display: 19.99
                      cost: null
                      cost_display: null
                      discount_percent: 0
                      pay_what_you_want: false
                      description: Product description
                      description_tabs:
                        - title: Features
                          content: <p>Instant delivery, 24/7 support.</p>
                      gateways:
                        - PAYPAL
                      custom_fields:
                        - name: Invite
                          type: text
                          required: true
                      delivery_instructions:
                        enabled: true
                        required: true
                        label: Discord username
                      volume_discounts: []
                      quantity_min: 1
                      quantity_max: -1
                      quantity_warning: 5
                      stock: 3
                      available_stock: 3
                      stock_delimiter: |+

                      unlisted: false
                      private: false
                      on_hold: false
                      sort_priority: 1
                      crypto_confirmations: 1
                      max_risk_level: 100
                      block_vpn_proxies: false
                      delivery_text: ''
                      delivery_time: null
                      service_text: ''
                      dynamic_webhook: https://example.com/hook
                      terms_of_service: null
                      warranty_days: 0
                      warranty_text: null
                      watermark_enabled: true
                      watermark_text: null
                      redirect_link: null
                      video_link: null
                      image_id: null
                      image_url: null
                      file_id: null
                      recurring_interval: null
                      recurring_interval_count: null
                      trial_period: null
                      licensing_enabled: false
                      license_period: null
                      affiliate_revenue_percent: 0
                      affiliate_customer_discount_mode: USE_STORE_DEFAULT
                      affiliate_customer_discount_percent: null
                      category_id: null
                      variants: []
                      created_at: 1711965600
                      updated_at: 1711965600
                  pagination:
                    next_cursor: null
                    has_more: false
                  stats:
                    total: 1
                    published: 1
                    low_stock: 1
                    out_of_stock: 0
        '400':
          description: Response for status 400
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - doc_url
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      doc_url:
                        type: string
                      details:
                        type: array
                        items:
                          type: object
                          required:
                            - field
                            - message
                          properties:
                            field:
                              type: string
                            message:
                              type: string
                          additionalProperties: true
                      subcode:
                        type: string
                    additionalProperties: true
                additionalProperties: true
        '401':
          description: Response for status 401
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - doc_url
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      doc_url:
                        type: string
                      details:
                        type: array
                        items:
                          type: object
                          required:
                            - field
                            - message
                          properties:
                            field:
                              type: string
                            message:
                              type: string
                          additionalProperties: true
                      subcode:
                        type: string
                    additionalProperties: true
                additionalProperties: true
        '403':
          description: Response for status 403
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - doc_url
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      doc_url:
                        type: string
                      details:
                        type: array
                        items:
                          type: object
                          required:
                            - field
                            - message
                          properties:
                            field:
                              type: string
                            message:
                              type: string
                          additionalProperties: true
                      subcode:
                        type: string
                    additionalProperties: true
                additionalProperties: true
        '404':
          description: Response for status 404
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - doc_url
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      doc_url:
                        type: string
                      details:
                        type: array
                        items:
                          type: object
                          required:
                            - field
                            - message
                          properties:
                            field:
                              type: string
                            message:
                              type: string
                          additionalProperties: true
                      subcode:
                        type: string
                    additionalProperties: true
                additionalProperties: true
        '422':
          description: Response for status 422
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - doc_url
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      doc_url:
                        type: string
                      details:
                        type: array
                        items:
                          type: object
                          required:
                            - field
                            - message
                          properties:
                            field:
                              type: string
                            message:
                              type: string
                          additionalProperties: true
                      subcode:
                        type: string
                    additionalProperties: true
                additionalProperties: true
        '429':
          description: Response for status 429
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - doc_url
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      doc_url:
                        type: string
                      details:
                        type: array
                        items:
                          type: object
                          required:
                            - field
                            - message
                          properties:
                            field:
                              type: string
                            message:
                              type: string
                          additionalProperties: true
                      subcode:
                        type: string
                    additionalProperties: true
                additionalProperties: true
      deprecated: false
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: Use your Shoppex API key in the Authorization header.

````