Storefront API - Products

Use this API to integrate with Product Information Management functionality built in to Customer's Canvas.

This API allows for working with products, options and variants you create in Customer's Canvas through the PIM (Product Information Management) module.

Api Clients

.Net Client

It is a part of the same packages as Storefront API. All classes related to PIM functionality are located in the Aurigma.Storefront.Products namespace.

You can install it from Nuget as follows:

Install-Package Aurigma.StorefrontApi.ApiClient

See on Nuget

Angular Client

This client is compatible with Angular applications only. It won't work with NodeJS or other frontend JS frameworks. You can install the package to your Angular application as follows:

@aurigma/ng-storefront-products-api-client

See on npm

NodeJS Client (Axious)

This client can be used in a wide range of JavaScript applications. To make API calls, it uses Axios - a popular HTTP library. Although it is possible to use it in both frontend and backend projects, the primary target platform for this library is NodeJS.

Install the package as follows:

npm install @aurigma/axios-storefront-products-api-client

See on npm

PHP Client

PHP client for this API is coming soon.

ProductReferences

These endpoints are used to manage storefront product references.

GetAll

Returns all storefront product references relevant to the specified query parameters.

Request

GET /api/storefront/v1/product-references/ext?storefrontId[&productReference&productId&productVersionId&productLinkId&skip&take&sorting&search&sku&tenantId]

Parameters

Name	In	Type	Default	Notes
productReference	query			Product reference filter. Product reference is an external reference to Customer's Canvas product specification, e.g online store product identifier.
productId	query			Cusomer's Canvas product filter.
productVersionId	query			Cusomer's Canvas product version filter.
productLinkId	query			Cusomer's Canvas product link filter.
skip	query			Defines page start offset from beginning of sorted result list.
take	query			Defines page length (how many consequent items of sorted result list should be taken).
sorting	query			Defines sorting order of result list e.g.: "Title ASC, LastModified DESC".
search	query			Search string for partial match.
sku	query			SKU filter.
*storefrontId	query			Storefront identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	PagedOfProductReferenceDto	Success
401		Unauthorized
403		Forbidden

Get

Returns a storefront product reference.

Request

GET /api/storefront/v1/product-references/ext/{reference}?storefrontId[&tenantId]

Parameters

Name	In	Type	Default	Notes
*reference	path			Product reference - external reference to Customer's Canvas products, e.g online store product identifier.
*storefrontId	query			Storefront identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	ProductReferenceDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

GetAllProductLinks

Returns a list of product links associated with storefront product references relevant to the specified query parameters.

Request

GET /api/storefront/v1/product-references/ext/product-links?storefrontId[&productReference&productId&productVersionId&productLinkId&skip&take&sorting&search&sku&tenantId]

Parameters

Name	In	Type	Default	Notes
productReference	query			Product reference filter. Product reference is an external reference to Customer's Canvas product specification, e.g online store product identifier.
productId	query			Cusomer's Canvas product filter.
productVersionId	query			Cusomer's Canvas product version filter.
productLinkId	query			Cusomer's Canvas product link filter.
skip	query			Defines page start offset from beginning of sorted result list.
take	query			Defines page length (how many consequent items of sorted result list should be taken).
sorting	query			Defines sorting order of result list e.g.: "Title ASC, LastModified DESC".
search	query			Search string for partial match.
sku	query			SKU filter.
*storefrontId	query			Storefront identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	PagedOfProductLinkDto	Success
401		Unauthorized
403		Forbidden

GetProduct

Returns a product by storefront product reference.

Request

GET /api/storefront/v1/product-references/ext/{reference}/product?storefrontId[&tenantId]

Parameters

Name	In	Type	Default	Notes
*reference	path			Product reference - external reference to Customer's Canvas product, e.g online store product identifier.
*storefrontId	query			Storefront identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	ProductDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

GetProductLink

Returns a product link by storefront product reference.

Request

GET /api/storefront/v1/product-references/ext/{reference}/product-link?storefrontId[&tenantId]

Parameters

Name	In	Type	Default	Notes
*reference	path			Product reference - external reference to Customer's Canvas product, e.g online store product identifier.
*storefrontId	query			Storefront identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	ProductLinkDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

GetProductFilter

Returns a product filter by storefront product reference.

Request

GET /api/storefront/v1/product-references/ext/{reference}/product-filter?storefrontId[&tenantId]

Parameters

Name	In	Type	Default	Notes
*reference	path			Product reference - external reference to Customer's Canvas product, e.g online store product identifier.
*storefrontId	query			Storefront identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	ProductFilterDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

GetProductPersonalizationWorkflow

Returns a product personalization workflow configuration by storefront product reference.

Request

GET /api/storefront/v1/product-references/ext/{reference}/product-personalization-workflow?storefrontId[&tenantId]

Parameters

Name	In	Type	Default	Notes
*reference	path			Product reference - external reference to Customer's Canvas product specification, e.g online store product identifier.
*storefrontId	query			Storefront identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	string	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

GetProductCostDetails

Returns a product cost details from ecommerce system.

Request

GET /api/storefront/v1/product-references/ext/{reference}/product-cost-details?sku&storefrontId[&storefrontUserId&currencyCode&quantity&tenantId]

Parameters

Name	In	Type	Default	Notes
*reference	path			Product reference - external reference to Customer's Canvas product product specification, e.g online store product identifier.
*sku	query			Product SKU.
*storefrontId	query			Storefront identifier.
storefrontUserId	query			Storefront user identifier.
currencyCode	query			Product cost currency code.
quantity	query		1	Product quantity.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	ProductCostDetailsDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

ObsoleteGetProduct

Returns a product by storefront product reference.

Request

GET /api/storefront/v1/product-references/{reference}/product?storefrontId[&tenantId]

Parameters

Name	In	Type	Default	Notes
*reference	path			Product reference - external reference to Customer's Canvas product, e.g online store product identifier.
*storefrontId	query			Storefront identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	ProductDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

ObsoleteGetProductLink

Returns a product link by storefront product reference.

Request

GET /api/storefront/v1/product-references/{reference}/product-link?storefrontId[&tenantId]

Parameters

Name	In	Type	Default	Notes
*reference	path			Product reference - external reference to Customer's Canvas product, e.g online store product identifier.
*storefrontId	query			Storefront identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	ProductLinkDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

ObsoleteGetProductFilter

Returns a product filter by storefront product reference.

Request

GET /api/storefront/v1/product-references/{reference}/product-filter?storefrontId[&tenantId]

Parameters

Name	In	Type	Default	Notes
*reference	path			Product reference - external reference to Customer's Canvas product, e.g online store product identifier.
*storefrontId	query			Storefront identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	ProductFilterDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

ObsoleteGetProductPersonalizationWorkflow

Returns a product personalization workflow configuration by storefront product reference.

Request

GET /api/storefront/v1/product-references/{reference}/product-personalization-workflow?storefrontId[&tenantId]

Parameters

Name	In	Type	Default	Notes
*reference	path			Product reference - external reference to Customer's Canvas product specification, e.g online store product identifier.
*storefrontId	query			Storefront identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	string	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

Products

These endpoints are used to get information about tenant products.

GetAllProducts

Returns all products, relevant to the specified query parameters.

Request

GET /api/storefront/v1/products[?skip&take&sorting&search&sku&tags&customFields&tenantId]

Parameters

Name	In	Type	Default	Notes
skip	query			Defines page start offset from beginning of sorted result list.
take	query			Defines page length (how many consequent items of sorted result list should be taken).
sorting	query			Defines sorting order of result list e.g.: "Title ASC, LastModified DESC".
search	query			Search string for partial match.
sku	query			SKU of linked ecommerce product.
tags	query			List of tags that product should have.
customFields	query			Serialized custom fields dictionary filter. For example: {"public":"true","name":"my item"}
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	PagedOfProductDto	Success
401		Unauthorized
403		Forbidden

GetProduct

Returns a product by identifier.

Request

GET /api/storefront/v1/products/{id}[?productVersionId&tenantId]

Parameters

Name	In	Type	Default	Notes
*id	path			Product identifier.
productVersionId	query			Product version identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	ProductDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

GetProductOptions

Returns a list of product options.

Request

GET /api/storefront/v1/products/{id}/options[?productVersionId&tenantId]

Parameters

Name	In	Type	Default	Notes
*id	path			Product identifier.
productVersionId	query			Product version identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	PagedOfProductOptionDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

GetAllProductOptions

Returns a list of product options for all products.

Request

GET /api/storefront/v1/products/options[?tenantId]

Parameters

Name	In	Type	Default	Notes
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	PagedOfProductOptionDto	Success
401		Unauthorized
403		Forbidden

GetProductLinks

Returns a list of product links.

Request

GET /api/storefront/v1/products/{id}/links[?productVersionId&skip&take&sorting&search&tenantId]

Parameters

Name	In	Type	Default	Notes
*id	path			Product identifier.
productVersionId	query			Product version identifier.
skip	query			Defines page start offset from beginning of sorted result list.
take	query			Defines page length (how many consequent items of sorted result list should be taken).
sorting	query			Defines sorting order of result list e.g.: "Title ASC, LastModified DESC".
search	query			Search string for partial match.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	PagedOfProductLinkDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

GetProductLink

Returns a product link.

Request

GET /api/storefront/v1/products/{id}/links/{productLinkId}[?productVersionId&tenantId]

Parameters

Name	In	Type	Default	Notes
*id	path			Product identifier.
*productLinkId	path			Product link identifier.
productVersionId	query			Product version identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	ProductLinkDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

GetProductFilters

Returns a list of product filters.

Request

GET /api/storefront/v1/products/{id}/filters[?productVersionId&filterType&skip&take&sorting&search&tenantId]

Parameters

Name	In	Type	Default	Notes
*id	path			Product identifier.
productVersionId	query			Product version identifier.
filterType	query			Defines filter type paramer.
skip	query			Defines page start offset from beginning of sorted result list.
take	query			Defines page length (how many consequent items of sorted result list should be taken).
sorting	query			Defines sorting order of result list e.g.: "Title ASC, LastModified DESC".
search	query			Search string for partial match.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	PagedOfProductFilterDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

GetProductFilter

Returns a product filter.

Request

GET /api/storefront/v1/products/{id}/filters/{productFilterId}[?productVersionId&tenantId]

Parameters

Name	In	Type	Default	Notes
*id	path			Product identifier.
*productFilterId	path			Product filter identifier.
productVersionId	query			Product version identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	ProductFilterDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

GetProductVariants

Returns a list of product variants.

Request

GET /api/storefront/v1/products/{id}/variants[?productVersionId&skip&take&options&productFilterId&takeAvailableOnly&sku&tenantId]

Parameters

Name	In	Type	Default	Notes
*id	path			Product identifier.
productVersionId	query			Product version identifier.
skip	query			Defines page start offset from beginning of sorted result list.
take	query			Defines page length (how many consequent items of sorted result list should be taken).
options	query			Defines options filter e.g.: "{ "opt1_id": "opt1_val1_id, opt1_val2_id", "opt2_id": "opt2_val1_id" }".
productFilterId	query			Defines special filter based on product filter with specified identifier.
takeAvailableOnly	query			Defines special filter for available product variants.
sku	query			SKU of linked ecommerce product.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	PagedOfProductVariantDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

GetProductVariantDesigns

Returns a list of product variant designs.

Request

GET /api/storefront/v1/products/{id}/variant-designs[?productVersionId&productVariantId&skip&take&options&productFilterId&takeAvailableOnly&sku&tenantId]

Parameters

Name	In	Type	Default	Notes
*id	path			Product identifier.
productVersionId	query			Product version identifier.
productVariantId	query			Product variant identifier.
skip	query			Defines page start offset from beginning of sorted result list.
take	query			Defines page length (how many consequent items of sorted result list should be taken).
options	query			Defines options filter e.g.: "{ "opt1_id": "opt1_val1_id, opt1_val2_id", "opt2_id": "opt2_val1_id" }".
productFilterId	query			Defines special filter based on product filter with specified identifier.
takeAvailableOnly	query			Defines special filter for available product variants.
sku	query			SKU of linked ecommerce product.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	PagedOfProductVariantDesignDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

GetProductVariantMockups

Returns a list of product variant mockups.

Request

GET /api/storefront/v1/products/{id}/variant-mockups[?productVersionId&productVariantId&skip&take&options&productFilterId&takeAvailableOnly&sku&tenantId]

Parameters

Name	In	Type	Default	Notes
*id	path			Product identifier.
productVersionId	query			Product version identifier.
productVariantId	query			Product variant identifier.
skip	query			Defines page start offset from beginning of sorted result list.
take	query			Defines page length (how many consequent items of sorted result list should be taken).
options	query			Defines options filter e.g.: "{ "opt1_id": "opt1_val1_id, opt1_val2_id", "opt2_id": "opt2_val1_id" }".
productFilterId	query			Defines special filter based on product filter with specified identifier.
takeAvailableOnly	query			Defines special filter for available product variants.
sku	query			SKU of linked ecommerce product.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	PagedOfProductVariantMockupDto	Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

UpdateProductVariantResources

Updates product variant resources.

Request

POST /api/storefront/v1/products/{id}/update-variant-resources[?productVersionId&tenantId]

Parameters

Name	In	Type	Default	Notes
*id	path			Product identifier.
productVersionId	query			Product version identifier.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200		Success
404	Microsoft.AspNetCore.Mvc.ProblemDetails	Not Found
401		Unauthorized
403		Forbidden

GetAvailableProductTags

Returns a list of all available product tags.

Request

GET /api/storefront/v1/products/available-tags[?search&tenantId]

Parameters

Name	In	Type	Default	Notes
search	query			Search string for partial match.
tenantId	query			Tenant identifier.

Responses

Status Code	Type	Description	Samples
200	array	Success
401		Unauthorized
403		Forbidden

Definitions

PagedOfProductReferenceDto

Paged list of items.

Name	Type	Notes
total	integer (int64)	Items count.
items	ProductReferenceDto[]	Items list.

ProductReferenceDto

Items list.

Name	Type	Notes
productReference	string	Product reference is an external reference to Customer's Canvas product specification, e.g online store product identifier.
productId	integer (int32)	Customer's Canvas product identifier.
productVersionId	integer (int32)	Customer's Canvas product version identifier.
productLinkId	integer (int32)	Customer's Canvas product link identifier.
storefrontId	integer (int32)	Storefront identifier.
tenantId	integer (int32)	Tenant identifier.
created	string (date-time)	Storefront product reference creation date and time.

Microsoft.AspNetCore.Mvc.ProblemDetails

Name	Type	Notes
type	string
title	string
status	integer (int32)
detail	string
instance	string

PagedOfProductLinkDto

Paged list of items.

Name	Type	Notes
total	integer (int64)	Items count.
items	ProductLinkDto[]	Items list.

ProductLinkDto

Items list.

Name	Type	Notes
id	integer (int32)	Product link identifier.
productVersionId	integer (int32)	Product version identifier.
productId	integer (int32)	Product identifier.
storefrontId	integer (int32)	Storefront identifier.
tenantId	integer (int32)	Tenant identifier.
name	string	Product link name.
description	string	Product link description.
tag	string	Product link tag.
storefrontProductId	string	Storefront product identifier.
storefrontProductName	string	Storefront product name.
productFilterId	integer (int32)	Product filter identifier.
image	ImageInfo[]	Product link image info.
productFilterOptions	ProductFilterOptionDto[]	Product filter options.

ImageInfo

Product link image info.

Name	Type	Notes
resourceId	string	Product resource identifier.
url	string	Product Resource URL.

ProductFilterOptionDto

Product filter options.

Name	Type	Notes
productOptionId	integer (int32)	Product option identifier.
productOptionValueId	integer (int32)	Product option value identifier.
productOptionType	OptionType	Product option type ('Simple' / 'Size' / 'PageCount').
productOptionTraits	array	Product option traits.
productOptionTitle	string	Product option title.
productOptionValueTitle	string	Product option value title.
isDefault	boolean	Indicates if option value should be used as a default value for corresponding option.

OptionType

Product option type ('Simple' / 'Size' / 'PageCount').

Enum Values

Simple Size PageCount

ProductDto

Dto class, containing information about a product.

Name	Type	Notes
id	integer (int32)	Product identifier.
productVersionId	integer (int32)	Product version identifier.
tenantId	integer (int32)	Tenant identifier.
name	string	Product name.
description	string	Product description.
created	string (date-time)	Product creation time.
lastModified	string (date-time)	Product modification time.
tags	array	Product tags.
customFields	object	Product custom fields.

ProductFilterDto

Dto class, containing information about a product filter.

Name	Type	Notes
id	integer (int32)	Product filter identifier
productVersionId	integer (int32)	Product version identifier
productId	integer (int32)	Product identifier
tenantId	integer (int32)	Tenant identifier
productFilterOptions	ProductFilterOptionDto[]	A list of product filter options
type	ProductFilterType	Product filter type

ProductFilterType

Product filter type

Enum Values

Link

ProductCostDetailsDto

Dto class, containing information about storefront product cost details.

Name	Type	Notes
productReference	string	Product reference is an external reference to Customer's Canvas product specification, e.g online store product identifier.
productSku	string	Product SKU.
productQuantity	integer (int32)	Product quantity.
productPrice	number (double)	Product price.
productCost	number (double)	Product cost.
productDiscount	number (double)	Product discount.
currencyCode	string	Currency code.
tenantId	integer (int32)	Tenant identifier.

PagedOfProductDto

Paged list of items.

Name	Type	Notes
total	integer (int64)	Items count.
items	ProductDto[]	Items list.

PagedOfProductOptionDto

Paged list of items.

Name	Type	Notes
total	integer (int64)	Items count.
items	ProductOptionDto[]	Items list.

ProductOptionDto

Items list.

Name	Type	Notes
id	integer (int32)	Product option identifier.
productVersionId	integer (int32)	Product version identifier
productId	integer (int32)	Product identifier.
tenantId	integer (int32)	Tenant identifier.
type	OptionType	Option type ('Simple' / 'Size' / 'PageCount').
traits	array	Option traits.
title	string	Product option title.
sortIndex	integer (int32)	Product option sort index.
tag	string	Product option tag.
useForDesignBinding	boolean	Specifies if the option is used for design binding.
useForMockupBinding	boolean	Specifies if the option is used for mockup binding.
description	string	Product option description.
tooltip	string	Product option tooltip.
appearanceData	AppearanceDataDto[]	Product option appearance.
image	ImageInfo[]	Product option image info.
productOptionValues	ProductOptionValueDto[]	A list of product option values.

AppearanceDataDto

Product option appearance.

Name	Type	Notes
type		Appearance type.
items	AppearanceDataItemDto[]	Appearance items.

AppearanceDataItemDto

Appearance items.

Name	Type	Notes
key	string	Appearance item key.
value	string	Appearance item value.

ProductOptionValueDto

A list of product option values.

Name	Type	Notes
id	integer (int32)	Product option value identifier.
title	string	Product option value title.
sortIndex	integer (int32)	Product option value sort index.
tag	string	Product option value tag.
simpleOptionValue	SimpleOptionValue[]	Option value description for 'Simple' option type.
description	string	Product option value description.
colors	array	Product option value colors.
image	ImageInfo[]	Product option value image.

SimpleOptionValue

Option value description for 'Simple' option type.

Name	Type	Notes
value	string	String Value.

PagedOfProductFilterDto

Paged list of items.

Name	Type	Notes
total	integer (int64)	Items count.
items	ProductFilterDto[]	Items list.

PagedOfProductVariantDto

Paged list of items.

Name	Type	Notes
total	integer (int64)	Items count.
items	ProductVariantDto[]	Items list.

ProductVariantDto

Items list.

Name	Type	Notes
id	integer (int32)	Product variant identifier.
productVersionId	integer (int32)	Product version identifier.
productId	integer (int32)	Product identifier.
tenantId	integer (int32)	Tenant identifier.
isAvailable	boolean	Product variant available.
sortIndex	integer (int32)	Product variant sort index.
storefrontProductVariantId	string	Product variant identifier (usually SKU) in storefront / online store.
productVariantOptions	ProductVariantOptionDto[]	A list of product variant options.

ProductVariantOptionDto

A list of product variant options.

Name	Type	Notes
productOptionId	integer (int32)	Product option identifier.
productOptionValueId	integer (int32)	Product option value identifier.
productOptionType	OptionType	Product option type ('Simple' / 'Size' / 'PageCount').
productOptionTraits	array	Product option traits.
productOptionTitle	string	Product option title.
productOptionValueTitle	string	Product option value title.
simpleOptionValue	SimpleOptionValue[]	Product option value description for 'Simple' option type.

PagedOfProductVariantDesignDto

Paged list of items.

Name	Type	Notes
total	integer (int64)	Items count.
items	ProductVariantDesignDto[]	Items list.

ProductVariantDesignDto

Items list.

Name	Type	Notes
productVariantId	integer (int32)	Product variant identifier.
productVersionId	integer (int32)	Product version identifier.
productId	integer (int32)	Product identifier.
tenantId	integer (int32)	Tenant identifier.
isAvailable	boolean	Product variant available.
sortIndex	integer (int32)	Product variant sort index.
storefrontProductVariantId	string	Product variant identifier in online store (usually SKU).
designId	string	Design identifier.
designName	string	Design name.
designGroup	string	Design grouping tag.
productVariantOptions	ProductVariantOptionDto[]	A list of product variant options.
productVariantResources	ProductVariantResourceDto[]	A list of product variant resources.

ProductVariantResourceDto

A list of product variant resources.

Name	Type	Notes
resourceId	string	Resource identifier.
name	string	Resource name.
url	string	Resource url.
type	ProductVariantResourceType	Resource type.
resourcePreview	ProductVariantResourcePreview[]	Product variant resource description for 'Preview' resource type.

ProductVariantResourceType

Resource type.

Enum Values

Preview EditorModel Custom

ProductVariantResourcePreview

Product variant resource description for 'Preview' resource type.

Name	Type	Notes
width	integer (int32)	Preview with in pixels.
height	integer (int32)	Preview heigth in pixels.

PagedOfProductVariantMockupDto

Paged list of items.

Name	Type	Notes
total	integer (int64)	Items count.
items	ProductVariantMockupDto[]	Items list.

ProductVariantMockupDto

Items list.

Name	Type	Notes
productVariantId	integer (int32)	Product variant identifier.
productVersionId	integer (int32)	Product version identifier.
productId	integer (int32)	Product identifier.
tenantId	integer (int32)	Tenant identifier.
storefrontProductVariantId	string	Product variant identifier in online store (usually SKU).
mockupId	string	Mockup identifier.
mockupName	string	Mockup name.
mockupType	ProductVariantMockupType	Mockup type.
surfaceIndex	integer (int32)	Surface index indicates a surface of a design to which mockup should be applied.
surfaceUsageType	SurfaceUsageType	Surface usage type defines a scheme for applying mockup to design surfaces.
productVariantOptions	ProductVariantOptionDto[]	A list of product variant options.

ProductVariantMockupType

Mockup type.

Enum Values

Thumbnail Editor Preview

SurfaceUsageType

Surface usage type defines a scheme for applying mockup to design surfaces.

Enum Values

Individual Custom All