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

# List products

> Retrieves a paginated list of products for the authenticated provider. Supports filtering by status, search term, and Managed MCP integration flag.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/sdk/products
openapi: 3.0.0
info:
  contact: {}
  description: The SolvaPay REST API specification
  title: SolvaPay REST API
  version: '1.0'
servers: []
security: []
tags: []
paths:
  /v1/sdk/products:
    get:
      tags:
        - Products
      summary: List products
      description: >-
        Retrieves a paginated list of products for the authenticated provider.
        Supports filtering by status, search term, and Managed MCP integration
        flag.
      operationId: ProductSdkController_listProducts
      parameters:
        - description: Max results (1-100)
          in: query
          name: limit
          required: false
          schema:
            example: 50
            type: number
        - description: Pagination offset
          in: query
          name: offset
          required: false
          schema:
            example: 0
            type: number
        - description: Search by name or description
          in: query
          name: search
          required: false
          schema:
            type: string
        - description: Filter by status
          in: query
          name: status
          required: false
          schema:
            enum:
              - active
              - inactive
            type: string
        - description: Filter Managed MCP integration products
          in: query
          name: isManagedMcp
          required: false
          schema:
            type: boolean
        - deprecated: true
          description: Deprecated alias of isManagedMcp
          in: query
          name: isMcpPay
          required: false
          schema:
            type: boolean
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  limit:
                    description: Applied page size (clamped to 1-100)
                    type: number
                  offset:
                    description: Applied pagination offset
                    type: number
                  products:
                    items:
                      $ref: '#/components/schemas/SdkProductResponse'
                    type: array
                  total:
                    description: Total number of products matching the filters
                    type: number
                type: object
          description: Products retrieved successfully
      security:
        - SecretKey: []
components:
  schemas:
    SdkProductResponse:
      properties:
        balance:
          description: Product balance in cents
          example: 0
          type: number
        config:
          allOf:
            - $ref: '#/components/schemas/ProductConfigDto'
          description: Product-specific configuration
        createdAt:
          description: Creation timestamp
          type: string
        description:
          description: Product description
          type: string
        imageUrl:
          description: URL to the product image
          type: string
        isManagedMcp:
          description: >-
            Whether this product uses the Managed MCP integration (SolvaPay
            reverse proxy)
          example: false
          type: boolean
        isMcpPay:
          deprecated: true
          description: >-
            Deprecated alias of isManagedMcp. Prefer isManagedMcp; still emitted
            for wire compatibility.
          example: false
          type: boolean
        mcp:
          additionalProperties: true
          description: MCP linkage details for MCP-enabled products
          example:
            defaultPlanRef: pln_FREE123
            mcpProxyUrl: https://acme-docs.mcp.solvapay.com/mcp
            mcpServerRef: mcp_ABC123
            mcpSubdomain: acme-docs
            originUrl: https://origin.example.com/mcp
          type: object
        metadata:
          additionalProperties: true
          description: Arbitrary key-value metadata
          type: object
        name:
          description: Product name
          example: AI Writing Assistant
          type: string
        plans:
          description: Plans associated with this product
          items:
            $ref: '#/components/schemas/SdkPlanResponse'
          type: array
        productType:
          description: Free-form product type
          type: string
        reference:
          description: Product reference
          example: prd_1A2B3C4D
          type: string
        status:
          description: Product status
          example: active
          type: string
        totalTransactions:
          description: Total number of transactions
          example: 0
          type: number
        updatedAt:
          description: Last update timestamp
          type: string
      required:
        - reference
        - name
        - balance
        - totalTransactions
        - isManagedMcp
        - isMcpPay
        - status
        - createdAt
        - updatedAt
      type: object
    ProductConfigDto:
      properties:
        deliveryMethod:
          description: Delivery method
          example: api
          type: string
        fulfillmentType:
          description: Fulfillment type
          example: digital
          type: string
        validityPeriod:
          description: Validity period in days
          example: 30
          type: number
      type: object
    SdkPlanResponse:
      properties:
        createdAt:
          description: Creation timestamp
          type: string
        currency:
          description: Currency code (ISO 4217)
          example: USD
          type: string
        currencySymbol:
          description: Currency symbol
          example: $
          type: string
        description:
          description: Plan description
          example: Best for teams getting started
          type: string
        features:
          additionalProperties: true
          description: Plan features
          type: object
        isActive:
          description: Whether the plan is active
          example: true
          type: boolean
        name:
          description: Plan name
          example: Starter
          type: string
        options:
          description: Composable pricing options (money as integer minor units)
          items:
            additionalProperties: true
            type: object
          type: array
        price:
          description: Derived headline price in minor units (base or one-time charge)
          example: 2999
          type: number
        reference:
          description: Plan reference
          example: pln_1A2B3C4D
          type: string
        requiresPayment:
          description: Whether payment is required
          example: true
          type: boolean
        status:
          description: Plan status
          example: active
          type: string
        type:
          description: Derived plan type (read from options)
          enum:
            - recurring
            - one-time
            - usage-based
            - hybrid
          example: recurring
          type: string
        updatedAt:
          description: Last update timestamp
          type: string
      required:
        - type
        - reference
        - options
        - currency
        - requiresPayment
        - isActive
        - status
        - createdAt
        - updatedAt
      type: object
  securitySchemes:
    SecretKey:
      bearerFormat: JWT
      description: >-
        Provider secret API key (sk_live_… / sk_test_…) supplied as a Bearer
        token.
      scheme: bearer
      type: http

````