---
title: "GET /api/styles/{id}"
method: GET
path: "/api/styles/{id}"
tags: ["Products/Styles"]
---

# GET /api/styles/{id}

`GET /api/styles/{id}`

## Path parameters

- `id` string, required

## Response `200`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
  - `data` StyleSchema, required
    - `id` string, required — Retraced-generated unique identifier for this style. Format is a ULID prefixed with 'style_' on newer records; legacy records may use an unprefixed alphanumeric ID. Stable — safe to store and use as a foreign key.
    - `externalId` unknown
    - `forCompanyId` string, required
    - `name` string, required
    - `codes` object[], required
      - `codeId` string, required — Identifier type for the code. Single-use (each may appear at most once): ERP_ID, PLM_ID, MAIN_SUPPLIERS_ID, PIM_ID, UPC_GTIN_12, EAN_GTIN_13, ZALANDO_ID, FASHIONCLOUD_ID. Multi-use (append a numeric suffix for additional entries, e.g. OTHER_ID1, OTHER_ID2): OTHER_ID, ALTERNATIVE_SUPPLIERS_ID.
      - `codeValue` string, required — The unique code value for this identifier, e.g. "ERP-001234".
    - `description` string
    - `gender` string
    - `styleLevelId` string, required — Retraced taxonomy identifier for the broad product level (e.g. APPAREL_END_CONSUMER_FINISHED_GOODS, FABRICS, TRIM_AND_ACCESSORIES). For the full list of valid values call GET /api/v2/style-types/ and read the parentId field.
    - `styleTypeId` string, required
    - `productLevel` unknown
    - `brands` string[]
    - `departments` string[]
    - `seasons` string[]
    - `collections` string[]
    - `claimIntentions` string[]
    - `customProperties` unknown
    - `suppliers` string[]
    - `mainSupplier` string
    - `vendors` string[]
    - `imagesFileIds` string[]
    - `images` object[]
      - `id` string, required
      - `url` string, required
      - `previewUrl` string, required
      - `fileType` unknown, required
      - `bucketName` string, required
      - `name` string, required
      - `fileSize` unknown, required
      - `contentType` unknown, required
      - `fileHash` unknown, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `createdBy` unknown
      - `createdByCompanyId` unknown
      - `createdByImpersonateId` unknown
      - `createdByImpersonateName` unknown
      - `createdByUserId` unknown
      - `createdByApiKeyId` unknown
      - `createdByApiKeyLabel` unknown
      - `updatedByUserId` unknown
      - `updatedByUserName` unknown
      - `updatedByCompanyId` unknown
      - `updatedByCompanyName` unknown
      - `updatedByImpersonateId` unknown
      - `updatedByImpersonateName` unknown
      - `updatedByApiKeyId` unknown
      - `updatedByApiKeyLabel` unknown
    - `isComponent` unknown
    - `isStoryActive` unknown
    - `isArchived` boolean, required — True if the product has been archived. Archived products are excluded from default API results.
    - `qrCodeUrl` unknown
    - `createdAt` string, date-time — ISO 8601 UTC timestamp of when the record was created.
    - `updatedAt` string, date-time — ISO 8601 UTC timestamp of when the record was last modified. Use with updatedAfterUnixMs for incremental sync.
    - `createdByImpersonateId` string
    - `createdByUserId` string
    - `createdByCompanyId` string
    - `createdByApiKeyId` string
    - `createdByApiKeyLabel` string
    - `updatedByImpersonateId` string
    - `updatedByUserId` string
    - `updatedByCompanyId` string
    - `updatedByApiKeyId` string
    - `updatedByApiKeyLabel` string
    - `ecoFootPrint` object
      - `syntheticMaterialPercentage` number
      - `recycledMaterialPercentage` number
      - `hazardousMaterials` object[]
        - `idx` number, required
        - `name` string, required
        - `percentage` number, required
      - `recyclabilityAbsenceDisruptor` unknown
      - `recyclabilityCanBeSorted` unknown
      - `recyclabilityCanCollectAtScale` unknown
      - `recyclabilityIndustrialScale` unknown
      - `recyclabilityRate` unknown
    - `weight` object
      - `unit` string, required
      - `value` number, required
    - `tracingStory` object
      - `id` string, required
      - `tracingType` string, required
      - `tracingId` string, required
      - `isActive` boolean, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `tracingName` unknown
    - `isWeightAvailable` boolean — True if a weight value has been recorded for this variant.

## Changes

> 22 revisions in range; 1 not diffed.

- **2026-08-31** `97e51f27dc77` — 29 breaking, 31 info
  - the response property `data/customProperties` became nullable for the status `200`
  - the response property `data/ecoFootPrint/anyOf[subschema #1]/recyclabilityAbsenceDisruptor` became nullable for the status `200`
  - the response property `data/ecoFootPrint/anyOf[subschema #1]/recyclabilityCanBeSorted` became nullable for the status `200`
  - the response property `data/ecoFootPrint/anyOf[subschema #1]/recyclabilityCanCollectAtScale` became nullable for the status `200`
  - …56 more

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/styles/:id/get.md)

---

[API](https://skmtc.dev/retraced/apis/api-reference.md) · [All operations](https://skmtc.dev/retraced/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/retraced/api-reference/revisions/97e51f27dc77/schema)