Products

List products

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

get/v1/sdk/products

Query parameters

limitnumber

Example:50

Max results (1-100)

offsetnumber

Pagination offset

searchstring

Search by name or description

status'active' | 'inactive'

Filter by status

isManagedMcpboolean

Filter Managed MCP integration products

isMcpPayboolean

Deprecated alias of isManagedMcp

Response

Products retrieved successfully

limitnumber

Applied page size (clamped to 1-100)

offsetnumber

Applied pagination offset

totalnumber

Total number of products matching the filters

Example response

{
  "products": [
    {
      "config": {
        "deliveryMethod": "api",
        "fulfillmentType": "digital",
        "validityPeriod": 30
      },
      "mcp": {
        "defaultPlanRef": "pln_FREE123",
        "mcpProxyUrl": "https://acme-docs.mcp.solvapay.com/mcp",
        "mcpServerRef": "mcp_ABC123",
        "mcpSubdomain": "acme-docs",
        "originUrl": "https://origin.example.com/mcp"
      },
      "name": "AI Writing Assistant",
      "plans": [
        {
          "currency": "USD",
          "currencySymbol": "$",
          "description": "Best for teams getting started",
          "isActive": true,
          "name": "Starter",
          "price": 2999,
          "reference": "pln_1A2B3C4D",
          "requiresPayment": true,
          "status": "active",
          "type": "recurring"
        }
      ],
      "reference": "prd_1A2B3C4D",
      "status": "active"
    }
  ]
}

Changes

Changed in 7 of the 27 revisions of this API.31214

Aug 14, 2026aeecbfb5cb3c4See the full diff
- ○
  added the new optional query request parameter isManagedMcp
  new-optional-request-parameter
- ○
  query request parameter isMcpPay was deprecated
  request-parameter-deprecated
- ○
  response property products/items/isMcpPay deprecated
  response-property-deprecated
- ○
  added the required property products/items/isManagedMcp to the response with the 200 status
  response-required-property-added
Aug 13, 2026e356f6586bf21See the full diff
- ○
  added the optional property products/items/plans/items/description to the response with the 200 status
  response-optional-property-added
Aug 5, 2026032545ac8d132121See the full diff
- ▲
  the response property products/items/plans/items/price became optional for the status 200
  response-property-became-optional
- ▲
  removed the required property products/items/plans/items/hidden from the response with the 200 status
  response-required-property-removed
- ●
  removed the optional property products/items/plans/items/billingCycle from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property products/items/plans/items/billingModel from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property products/items/plans/items/creditsPerUnit from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property products/items/plans/items/description from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property products/items/plans/items/freeUnits from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property products/items/plans/items/limit from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property products/items/plans/items/limits from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property products/items/plans/items/measures from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property products/items/plans/items/meterRef from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property products/items/plans/items/rolloverUnusedUnits from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property products/items/plans/items/setupFee from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property products/items/plans/items/trialDays from the response with the 200 status
  response-optional-property-removed
- ○
  added the required property products/items/plans/items/options to the response with the 200 status
  response-required-property-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 30, 20268578b7536a9f3See the full diff
- ○
  added the optional property products/items/plans/items/description to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property products/items/plans/items/name to the response with the 200 status
  response-optional-property-added
- ○
  added the required property products/items/plans/items/type to the response with the 200 status
  response-required-property-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 17, 2026bbc2ff2bc84911See the full diff
- ▲
  removed the enum value suspended from the query request parameter status
  request-parameter-enum-value-removed
- ○
  added the required property products/items/plans/items/hidden to the response with the 200 status
  response-required-property-added
Jul 4, 2026a30b6aef464d3See the full diff
- ○
  the endpoint scheme security SecretKey was added to the API
  api-security-added
- ○
  the endpoint scheme security bearer was removed from the API
  api-security-removed
- ○
  added the media type application/json for the response with the status 200
  response-media-type-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 27, 20269079f361f51c1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history