---
title: "Returns a featured recommendation"
method: GET
path: "/recommendation/featured/{id}"
tags: ["Recommendation"]
---

# Returns a featured recommendation

`GET /recommendation/featured/{id}`

## Request

- The document declares no server URL.
- Auth: API key in header `TWN-InstanceKey` and API key in header `TWN-Authentication`

## Path parameters

- `id` integer, required

## Response `200`

OK

- FeaturedRecommendationApiModel: Full details of a featured recommendation.
  - `RecommendationId` integer: Featured recommendation identifier.
  - `Name` string: Name of the featured recommendation.
  - `BuilderId` integer, nullable: Builder identifier.
  - `AmountOfResults` integer: Number of products to return.
  - `CategoryId` integer: Category identifier for the recommendation.
  - `SortingId` integer: Sort option identifier.
  - `RecommendationRefinedSelection` 'None' | 'Category' | 'Attribute': Type of refined selection for featured and product recommendations.
  - `RefinedSelectionAttributeId` integer, nullable: Attribute identifier for refined selection when RefinedSelection is Attribute.
  - `Filters` FeaturedRecommendationFilterAttributeApiModel[]: List of attribute filters for this recommendation.
    - `AttributeId` integer: Attribute identifier for this filter.
    - `Type` 'MultiValue' | 'Range': Type of filter for featured recommendation filters.
    - `Operator` 'Equals' | 'NotEquals': Operator for featured recommendation filters.
    - `Values` string[], nullable: Values for MultiValue filter type. Null for Range type.
    - `Min` integer, nullable: Minimum value for Range filter type. Null for MultiValue type.
    - `Max` integer, nullable: Maximum value for Range filter type. Null for MultiValue type.
  - `IncludeExcludeParameters` integer[]: List of dynamic parameter attribute identifiers.
  - `IsBuilderComponent` boolean: Indicates if this recommendation is a builder component.

## Other responses

- `404`: Not Found

---

[API](https://skmtc.dev/tweakwise/apis/app-api.md) - [All operations](https://skmtc.dev/tweakwise/apis/app-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tweakwise/apis/app-api/revisions/dc936bf76941?raw)
