--- title: "POST /api/admin/styles/list" method: POST path: "/api/admin/styles/list" tags: ["Administration/Styles"] --- # POST /api/admin/styles/list `POST /api/admin/styles/list` ## Request body - object - `limit` integer — Number of results per page. The default and maximum vary per endpoint. - `page` integer — Page number (1-based). Defaults to 1. - `order` 'asc' | 'desc' | 'ASC' | 'DESC' - `sort` 'createdAt' | 'updatedAt' | 'name' | 'gender' | 'typeName' - `name` string - `nameOrCode` string - `codes` object - `codeId` string - `codeValue` string - `description` string - `gender` string - `styleTypeId` string - `styleLevelId` string - `brands` string[] - `departments` string[] - `seasons` string[] - `collections` string[] - `suppliers` string[] - `mainSupplier` string - `vendors` string[] - `linkedCompanyId` string — Match styles where this company id appears in main_supplier, suppliers (CSV), or vendors (CSV). - `imagesFileIds` string[] - `isComponent` boolean - `isStoryActive` boolean - `isArchived` boolean - `createdForMe` boolean - `isCreatedForNetwork` boolean - `include` string[] - `companyId` string - `certValidationStandardId` string - `certValidationExpirationDate` string - `certValidationIssueDate` string - `updatedAfterUnixMs` number - `updatedBeforeUnixMs` number ## Response `200` Default Response - object - `metadata` object, required - `success` boolean, required — True when the request succeeded. - `pagination` object - `page` number, required — Current page number (1-based). - `limit` number, required — Page size used for this response. Endpoint defaults vary — see each endpoint's limit parameter. - `total` number, required — Total number of records across all pages. - `totalPages` number, required — Total number of pages. Iterate until page reaches totalPages. - `data` object[], 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` string — Your own identifier for this product, if one was supplied on create. Null otherwise. - `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` string - `brands` string[] - `departments` string[] - `seasons` string[] - `collections` string[] - `claimIntentions` string[] - `customProperties` string - `suppliers` string[] - `mainSupplier` string - `vendors` string[] - `imagesFileIds` string[] - `images` object[] - `id` string, required - `url` string, required - `previewUrl` string, required - `fileType` string, required - `bucketName` string, required - `name` string, required - `fileSize` number, required - `contentType` string, required - `fileHash` string, required - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `createdBy` string - `createdByCompanyId` string - `createdByImpersonateId` string - `createdByImpersonateName` string - `createdByUserId` string - `createdByApiKeyId` string - `createdByApiKeyLabel` string - `updatedByUserId` string - `updatedByUserName` string - `updatedByCompanyId` string - `updatedByCompanyName` string - `updatedByImpersonateId` string - `updatedByImpersonateName` string - `updatedByApiKeyId` string - `updatedByApiKeyLabel` string - `isComponent` union - boolean - number - `isStoryActive` union — Whether the public traceability page (product story) is active for this product. Activating it requires tracing data (e.g. a supply chain) to be attached to the product first. - boolean - number - `isArchived` boolean, required — True if the product has been archived. Archived products are excluded from default API results. - `qrCodeUrl` string — URL of the product's pre-generated QR code image (an SVG hosted on the Retraced CDN). Null until generation completes, which happens asynchronously after the product is created. The QR image encodes a Retraced-managed forwarding URL that resolves to the product's traceability page once the story is active. The URL is stable once generated — it is not regenerated when product data changes. - `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` boolean - `recyclabilityCanBeSorted` boolean - `recyclabilityCanCollectAtScale` boolean - `recyclabilityIndustrialScale` boolean - `recyclabilityRate` number - `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` string - `isWeightAvailable` boolean — True if a weight value has been recorded for this variant. - `featureImageUrl` string - `material` object - `id` string, required - `name` string, required - `description` string - `lines` object[] - `id` string, required - `rawMaterialId` string, required - `rawMaterialName` string, required - `percentage` number, required - `countriesOfOrigin` string, required - `bom` object[] - `id` string, required - `name` string, required - `styleProperties` object - `brands` object[] - `id` string, required - `name` string, required - `category` string, required - `departments` object[] - `id` string, required - `name` string, required - `category` string, required - `seasons` object[] - `id` string, required - `name` string, required - `category` string, required - `collections` object[] - `id` string, required - `name` string, required - `category` string, required - `type` object - `id` string, required - `name` string, required - `parentId` string, required - `quantityUnits` string[], required - `weightUnits` string[], required - `linkedStyles` object[] - `styleId` string, required - `validationResult` object - `valid` boolean, required - `selectable` boolean, required - `description` array[], required - object[] - `type` string, required - `text` string, required - `certificateDuplications` object[], required - `type` string, required - `text` string, required - `claimId` string --- [API](https://skmtc.net/retraced/apis/api-reference.md) · [All operations](https://skmtc.net/retraced/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/retraced/api-reference/revisions/60d6c901bc4e/schema)