---
title: "Returns a builder"
method: GET
path: "/builder/{id}"
tags: ["Builder"]
---

# Returns a builder

`GET /builder/{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

- PersonalMerchandisingApiModel: Builder
  - `BuilderId` integer: Id of the builder
  - `Name` string, nullable: Name of the builder
  - `Type` 'ListerPage' | 'Recommendation'
  - `Items` PersonalMerchandisingItemApiModel[], nullable: List of builder items
    - `ComponentId` string, uuid: Unique id of the builder item
    - `RecommendationId` integer, nullable: Recommendation id
    - `RecommendationGroupKey` string, nullable: Recommendation groupkey
    - `Type` 'featuredrec' | 'lastviewedproduct' | 'productrecgroup' | 'lastpurchasedproduct' | 'personalproduct' | 'brandproduct' | 'property' | 'externaldata' | 'contentitem' | 'organic' | 'aipersonal': Type of the builder item
    - `ContentItemType` string, nullable: Content itemtype
    - `BrandValue` string, nullable: Brand value
    - `AttributeId` integer, nullable: Attribute id
    - `ItemId` string, nullable: Item id
    - `AttributeValue` string, nullable: Attribute value
    - `ExternalDataComponentId` integer, nullable: External data component id
    - `Position` integer: Position of the item on page
    - `ColSpan` integer: Column span of the item
    - `RowSpan` integer: Row span of the item

## 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)