---
title: "List Recommended Products"
method: POST
path: "/onboarding/product-recommendations"
tags: ["Products"]
---

# List Recommended Products

`POST /onboarding/product-recommendations`

Get recommender products to fetch multiple items related to a client

## Request body

- ProductRecommendationRequest — Recommender products payload attributes
  - `partnerName` string, nullable — The name of the partner that referred the lead to the business.
  - `annualVolume` integer, required — The annual volume of transactions processed by the business.
  - `hasMajorityOwnership` boolean, required — A boolean value indicating whether the business has majority ownership.
  - `hasExistingRelationship` boolean, required — A boolean value indicating whether the business has an existing relationship with the service provider.
  - `hasMultipleLocations` boolean, required — A boolean value indicating whether the business has multiple locations.
  - `locationProvince` string, iso-3166-2, required — Province or state ISO 3166-2 code
  - `merchantCategoryCode` string, required — A four-digit code that classifies the type of business or service provided by the merchant, based on standard industry categories.
  - `solutionId` integer — A unique identifier for the solutions object.
  - `isAllowedToSell` boolean — A boolean value indicating whether the business is allowed to sell the solution.
  - `isOnline` boolean — A boolean value indicating whether the solution is available for online transactions.
  - `isInstore` boolean — A boolean value indicating whether the solution is available for in-store transactions.
  - `directSellingPercentage` number — The percentage of transactions processed through direct selling.
  - `motoTransactionPercentage` number — The percentage of transactions processed through mail order / telephone order.
  - `ecommerceTransactionPercentage` number — The percentage of transactions processed through e-commerce.

## Response `200`

Successful response corresponding to the provided payload

- ProductRecommendation — An object containing all details related to a product recommendation.
  - `allowToSell` boolean — A boolean value indicating whether the business is allowed to sell the solution.
  - `solutions` Solution[] — A list of solution items.
    - `solutionIdentifier` integer, required — The unique identifier for the solution.
    - `solutionName` string, required — The name of the solution.
    - `solutionDescription` string, required — A detailed description of the solution.
    - `solutionImageUrl` string, required — The URL of the image associated with the solution.
    - `solutionPrices` SolutionPricing[] — A list of pricing options associated with the solution.
      - `pricingLabel` string, required — The label associated with the pricing option.
      - `pricingText` string, required — The text associated with the pricing option.
    - `solutionFeatures` SolutionFeature[] — A list of features associated with the solution.
      - `description` string, required — A detailed description of the feature.
    - `promotionalBlock` string, nullable — A promotional block associated with the solution.
    - `additionalSolutionDetailsUrl` string, nullable — The URL for additional details about the solution.
    - `maximumQuantity` integer — The maximum quantity of the solution that can be purchased.
    - `carrierOptions` string[] — A list of carrier options available for the solution.

## Other responses

- `400` — Bad Request.
- `401` — Not authorized. The user does not have a valid API Key or Access Token.
- `403` — Forbidden. The user does not have permission to access the requested resource.
- `422` — The API cannot complete the requested action due to semantic or business validation errors.
- `429` — Too Many Requests
- `500` — Unexpected error.
- `503` — Service Temporarily Unavailable

---

[API](https://skmtc.net/moneris/apis/moneris-api.md) · [All operations](https://skmtc.net/moneris/apis/moneris-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moneris/moneris-api/revisions/edefcc925b74/schema)