v1

latestOpenAPI 3.0.32026-07-173196215.4 KB
products

Get a product

Get one product by productId.

get/v1/products/{productId}

Path parameters

productIdinteger required

Get product with specified productId.

Query parameters

campaignKeystring

Adjust prices based on the specified campaignKey. If results are not having a matching campaign, the default price is returned.

Please note, that campaign prices are stored in advance and available earlier than the campaign starts.

withstring[]

Include related product resources, for example, the attributes of a product can be included using with=attributes or with=attributes:key(plusSize). Nested includes can be included with with=variants.attributes. Multiple includes are separated by commas with=siblings,variants.

withincludes
attributessee attributes filtering below
advancedAttributessee attributes filtering below
variantsfull variants
variants.<include>partial variants (see available includes for variants in /variants endpoint)
imagesimages (included by default)
images.attributessee attributes filtering below
categoriescategories
categories:hidden(true)also include hidden categories
categories.countryLevelCustomDatainclude country custom data information
categories.shopLevelCustomDatainclude shop custom data information
categories.categoryProperties:name(property_name)only return specified categoryProperties for included categories
definingAttributesdefiningAttributes
siblingssibling products
siblings.<include>partial sibling products (see available includes for products in /products endpoint)
priceRangepriceRange
lowestPriorPricelowestPriorPrice
reductionRangereductionRange
searchCategoryIdssearchCategoryIds
baseCategoriesbaseCategories
filters for with=attributes, with=advancedAttributes and with=images.attributesincludes
attributesall attributes
attributes:key(<key>|<key>|...)only attributes with specified keys
attributes:type(<type>|<type>|...)only attributes with specified types
pricePromotionKeystring

Adjust variant price based on the specified pricePromotionKey. If the variant does not have a matching price promotion, the default price is returned.

Response

successful operation

idinteger required
advancedAttributesobject
attributesobject
customDataResponseCustomData required
isActiveboolean required

Identifies whether a product is active or not

isNewboolean required

Identifies whether a product is new or not

isSoldOutboolean required

Identifies if a product is still available to sell

masterKeystring required

Identifies the master product which this product belongs

firstLiveAtstring required

Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00

referenceKeystring required
searchCategoryIdsinteger[]
createdAtstring required

Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00

updatedAtstring required

Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00

indexedAtstring required

Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00