---
title: "Retrieve variation product details"
method: GET
path: "/v1/variations"
tags: ["Product details"]
---

# Retrieve variation product details

`GET /v1/variations`

## Request

- Base URL: `https://product-details.cnstrc.com`
- URL: `https://product-details.cnstrc.com/v1/variations`
- Auth: none required

Retrieve requested product detail fields for one or more variations. Results preserve request order and repeated IDs. Every requested ID has a corresponding response entry.

## Query parameters

- `key` string, required: The key of the index to use.
- `section` string, required: The section of the index to use (e.g. 'Products').
- `variation_id` string[], required: 1 to 100 variation IDs to retrieve product details for. Repeat this parameter to specify multiple IDs.
- `c` string, nullable: The ID of the client and version that the request is coming from, such as `cio-js-2.90`.
- `ui` string, nullable: A customer generated anonymized identifier for a user on a customer website. It should only be sent for logged in customers and helps Constructor to tie multiple client and session IDs together to form a behavioral data profile across devices.
- `fields` string[], required: One or more product detail fields to include in the response. This parameter may be repeated to specify multiple fields.
- `s` integer, nullable: An integer representing the users session number (starting with `1`), incremented after a 30 minute period of inactivity.
- `i` string, nullable: A globally unique identifier for the user browser (or mobile application instance) making the request.

## Response `200`

OK

- VariationsGetResponse: Full response for GET /v1/variations.
  - `trace_id` string, required
  - `response` object, required
    - `variations` Variation[], required
      - `variation_id` string, required
      - `enriched_attributes` EnrichedAttributes, required: Enriched attributes: resolved badges and attributes keyed by name.
        - `badges` Badge[], required
          - `type` string, required
          - `display_name` string, required
          - `metadata` object
        - `attributes` object, required

## Other responses

- `400`: Validation Error
- `401`: Unauthorized

---

[API](https://skmtc.dev/constructor/apis/product-details.md) - [All operations](https://skmtc.dev/constructor/apis/product-details/llms.txt) - [OpenAPI document](https://skmtc.dev/constructor/apis/product-details/revisions/a16f1fcc58a8?raw)