Product document (Data API 23.2)

(supports custom properties)

Document representing a product

Property Type Constraints Description
assigned_categories [CatalogCategoryId]   The catalog categories that the product is assigned to
ats Decimal   The ATS(Available To Sell) inventory value of the product. This is a calculated value.
brand String   The brand of the product.
bundled_products [Product]   The array of bundled products which the product includes.
classification_category CatalogCategoryId   The classification category (default category) of the product
creation_date Date   Returns the value of attribute 'creationDate'.
default_variant_id String   The ID of the product's default variant.
ean String   The European Article Number of the product.
id String maxLength=100, minLength=1 The ID (SKU) of the product.
image MediaFile   The image(s) assigned to the product.
image_groups [ImageGroup]   The array of product image groups.
in_stock Boolean   The flag that indicates if the product is in stock, or not. This is a calculated value.
last_modified Date   Returns the value of attribute 'lastModified'.
link String   A link to the product.
localized_tax_class_id Localized<String>    
long_description Localized<MarkupText>   The localized long description of the product.
manufacturer_name String   The name of the product's manufacturer.
manufacturer_sku String   The SKU of the product's manufacturer.
master Master   The master of the product. This is applicable for product types "variation_group" and "variant" only.
name Localized<String>   The localized name of the product.
online Boolean   The flag that indicates if the product is online, or not. This is a calculated value.
online_flag SiteSpecific<Boolean>   The site specific online status of the product.
owning_catalog_id String   The ID of the catalog that owns the product.
owning_catalog_name Localized<String>   The localized name of the catalog that owns the product.
page_description Localized<String>   The localized page description of the product.
page_keywords Localized<String>   The localized page keywords of the product.
page_title Localized<String>   The localized page title of the product.
price Decimal   The price of the product.
price_currency String   The currency code for product's price.
price_per_unit Decimal   The price per unit of the product
primary_categories [CatalogCategoryId]   The catalog categories that are primary for the product
primary_category_id String   The id of the products primary category.
product_bundles [Product]   The array of product bundles which the product belongs to.
product_options [ProductOption]   The array of product options. This is applicable for products of type "option".
product_sets [Product]   The array of product sets which the product belongs to.
searchable SiteSpecific<Boolean>   The site specific searchable status of the product.
set_products [Product]   The array of set products which the product includes.
short_description Localized<MarkupText>   The localized short description of the product.
tax_class_id String   The catalog categories that the product is assigned to
type ProductType   The type of the product. It can have one or more of the values "item", "master", "variation_group", "variant", "bundle", and "set".
unit String   The sales unit of the product.
unit_measure String   The unitMeasure of the product.
unit_quantity Decimal   The unitQuantity of the product.
upc String   The Universal Product Code of the product.
valid_from SiteSpecific<DateTime>   The time when product is valid from.
valid_to SiteSpecific<DateTime>   The time when product is valid to.
variants [Variant]   The array of variants of the product. This is applicable for product types "master" and "variation_group" only.
variation_attributes [VariationAttribute]   The sorted array of variation attributes assigned to the product. This is applicable for product types "master", "variation_group" and "variant" only.
variation_groups [VariationGroup]   The array of variation groups in the product. This is applicable for product type "master" only.
variation_values Map[String, String]   The variation values selected for the product in variation attribute id and value pairs. This is applicable for product types "variant" and "variation_group" only.
X OCAPI versions 15.x and 16.x will be retired on March 31, 2021. For dates and more information, see the OCAPI versioning and deprecation policy and this Knowledge Article.