---
title: "List Recommendations"
method: POST
path: "/recommendations.recommend"
tags: ["Products"]
---

# List Recommendations

`POST /recommendations.recommend`

Retrieves recommended Quote items for a customer, segment, or a product.<p>
See also: [Configure Recommended Items](https://knowledge.pricefx.com/configuration-engineer-knowledge-base/how-to/quoting-howto/configure-recommended-items) Knowledge base article.<p>
If the endpoint receives a request data containing a Quote `typedId` and a `QuoteProductFilter` logic is configured in the partition (see [Quote Product Picker Filter Logic](https://pricefx.atlassian.net/wiki/spaces/KB/pages/3790274667/Quote+Product+Picker+Filter+Logic)), then the endpoint will evaluate this logic with the corresponding Quote and gives the resulting `Filter` object to the recommendation model evaluation.

## Request body

- object
  - `data` object, required
    - `customers` string[]
    - `products` string[] — Specify SKUs that have been already added to the Quote to exclude them from recommendations. Use the **/clicmanager.fetchitemuniquetypes/{typedId}** endpoint to retrieve these SKUs.
    - `excludeProducts` string[] — Specify any products (SKUs) you want to explicitly exclude from recommendations.
    - `maxResults` integer
    - `typedId` string — `typedId` of the Quote you want to get the recommendations for.

## Response `200`

OK

- object
  - `response` object
    - `node` string
    - `data` object[]
      - `categoryName` string
      - `items` object[]
        - `item` object
          - `version` integer
          - `typedId` string
          - `sku` string
          - `label` string
          - `unitOfMeasure` string, nullable
          - `userGroupEdit` string, nullable
          - `userGroupViewDetails` string, nullable
          - `currency` string
          - `formulaName` string, nullable
          - `image` string, nullable
          - `createDate` string
          - `createdBy` integer
          - `lastUpdateDate` string
          - `lastUpdateBy` integer
          - `attribute1` string, nullable
          - `attribute2` string, nullable
          - `attribute3` string, nullable
          - `attribute4` string, nullable
          - `attribute5` unknown
          - `attribute6` string, nullable
          - `attribute7` integer, nullable
          - `attribute8` string, nullable
          - `attribute9` string, nullable
          - `attribute10` string, nullable
          - `attribute11` string, nullable
          - `attribute12` string, nullable
          - `attribute13` string, nullable
          - `attribute14` string, nullable
          - `attribute15` string, nullable
          - `attribute16` string, nullable
          - `attribute17` string, nullable
          - `attribute18` string, nullable
          - `attribute19` string, nullable
          - `attribute20` string, nullable
          - `attribute21` string, nullable
          - `attribute22` string, nullable
          - `attribute23` string, nullable
          - `attribute24` string, nullable
          - `attribute25` string, nullable
          - `attribute26` string, nullable
          - `attribute27` string, nullable
          - `attribute28` string, nullable
          - `attribute29` string, nullable
          - `attribute30` string, nullable
        - `score` integer
    - `status` integer

---

[API](https://skmtc.net/pricefx/apis/the-pricefx-backend-api.md) · [All operations](https://skmtc.net/pricefx/apis/the-pricefx-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pricefx/the-pricefx-backend-api/versions/0850b5d6be73/schema)