listItemTypes
get
/ccstore/v1/itemTypes
List Item Types. Get item type info and base type info of a list of item types.
Request
Supported Media Types
- application/json
Query Parameters
-
includeBase(optional): boolean
Set to true to get base type details.
-
itemTypeIds: string
Comma separated list of item types to be returned
-
parent(optional): string
Parent Type of current requested item type. It takes product as default parent for custom types.
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Root Schema : listItemTypes_response
Type:
Show Source
object
-
items(optional):
array items
Array containing the properties of the item type ids in the request
Nested Schema : items
Type:
array
Array containing the properties of the item type ids in the request
Show Source
Nested Schema : items
Type:
Show Source
object
-
base(optional):
array base
Base type Details
-
count(optional):
integer
The count of items.
-
displayName(optional):
string
The display name of the item type
-
id(optional):
string
The ID of the item type.
-
shopperInputs(optional):
array shopperInputs
Shopper Inputs corresponding to the productType
-
specifications(optional):
array specifications
List of properties for user-defined item type.
-
variants(optional):
array variants
Variants of the product
Nested Schema : shopperInputs
Type:
array
Shopper Inputs corresponding to the productType
Show Source
Nested Schema : specifications
Type:
array
List of properties for user-defined item type.
Show Source
Nested Schema : items
Type:
Show Source
object
-
default(optional):
string
Default specification of product type.
- hidden(optional): boolean
-
id(optional):
string
ID of specification.
-
itemType(optional):
string
Item type for user-defined product.
-
label(optional):
string
Label for new item type.
-
length(optional):
integer
The length property of the variant
-
listingVariant(optional):
boolean
Whether listing should be done based on this variant.
-
localizable(optional):
boolean
Whether Localizable or not.
-
order(optional):
integer
Order count of item type.
-
required(optional):
boolean
Whether it is required or not.
-
type(optional):
string
Data type of variant.
-
uiEditorType(optional):
string
The UIEditorType property of the variant
-
variantBasedDisplay(optional):
boolean
Whether this variant based display should be allowed
-
writable(optional):
string
Whether writable or not.
Nested Schema : items
Type:
Show Source
object
-
id(optional):
string
Id corresponding to the shopperInput
-
label(optional):
string
The display label of the shopperInput
-
name(optional):
string
The name of the shopperInput
-
promptText(optional):
string
The descriptive text for the shopperInput
-
required(optional):
boolean
Whether it is required or not.
-
type(optional):
string
Data type of shopperInput.
-
uiEditorType(optional):
string
The UIEditorType property of the shopperInput
-
values(optional):
array values
List of allowed values in case of Single Selection List type.
Nested Schema : values
Type:
array
List of allowed values in case of Single Selection List type.
Show Source
Nested Schema : items
Type:
Show Source
object
-
default(optional):
string
Default specification of product type.
- hidden(optional): boolean
-
id(optional):
string
ID of specification.
-
itemType(optional):
string
Item type for user-defined product.
-
label(optional):
string
Label for new item type.
-
length(optional):
integer
The length property of the variant
-
listingVariant(optional):
boolean
Whether listing should be done based on this variant.
-
localizable(optional):
boolean
Whether Localizable or not.
-
order(optional):
integer
Order count of item type.
-
required(optional):
boolean
Whether it is required or not.
-
type(optional):
string
Data type of variant.
-
uiEditorType(optional):
string
The UIEditorType property of the variant
-
validationPattern(optional):
string
Regex string for the validations to be applied on the field. Applicable only for ContactInfo item type.
-
variantBasedDisplay(optional):
boolean
Whether this variant based display should be allowed
-
writable(optional):
string
Whether writable or not.
Nested Schema : items
Type:
Show Source
object
-
default(optional):
string
Default specification of product type.
- hidden(optional): boolean
-
id(optional):
string
ID of specification.
-
itemType(optional):
string
Item type for user-defined product.
-
label(optional):
string
Label for new item type.
-
length(optional):
integer
The length property of the variant
-
listingVariant(optional):
boolean
Whether listing should be done based on this variant.
-
localizable(optional):
boolean
Whether Localizable or not.
-
order(optional):
integer
Order count of item type.
-
required(optional):
boolean
Whether it is required or not.
-
type(optional):
string
Data type of variant.
-
uiEditorType(optional):
string
The UIEditorType property of the variant
-
variantBasedDisplay(optional):
boolean
Whether this variant based display should be allowed
-
writable(optional):
string
Whether writable or not.
Example Response (application/json)
{
"items":[
{
"shopperInputs":[
{
"uiEditorType":"shortText",
"values":[
],
"name":"Gift Message",
"label":"Gift Message",
"id":"giftMessage",
"promptText":"Enter the gift message",
"type":"shortText",
"required":false
}
],
"id":"sku",
"specifications":[
{
"itemType":"sku",
"hidden":false,
"length":254,
"variantBasedDisplay":false,
"label":"baseLevelSkuProperty",
"type":"shortText",
"required":false,
"writable":true,
"default":null,
"listingVariant":false,
"propertyType":"sku-base",
"localizable":false,
"id":"baseLevelSkuProperty",
"order":null
}
],
"base":[
{
"itemType":"sku",
"hidden":false,
"length":254,
"variantBasedDisplay":false,
"label":"Name",
"type":"shortText",
"required":false,
"writable":true,
"uiEditorType":null,
"default":null,
"listingVariant":false,
"localizable":true,
"id":"displayName",
"order":"-11"
},
{
"itemType":"sku",
"hidden":false,
"length":165,
"variantBasedDisplay":false,
"label":"Id",
"type":"shortText",
"required":false,
"writable":false,
"uiEditorType":null,
"default":null,
"listingVariant":false,
"localizable":false,
"id":"id",
"order":"-4"
},
{
"itemType":"sku",
"hidden":false,
"length":1,
"variantBasedDisplay":false,
"label":"Active",
"type":"checkbox",
"required":false,
"writable":true,
"uiEditorType":null,
"default":true,
"listingVariant":false,
"localizable":false,
"id":"active",
"order":"50"
}
]
},
{
"id":"sku-MensApparel",
"specifications":[
{
"itemType":"sku-MensApparel",
"hidden":false,
"length":254,
"variantBasedDisplay":false,
"label":"customLevelSkuProperty",
"type":"shortText",
"required":false,
"writable":true,
"default":null,
"listingVariant":false,
"propertyType":"sku-custom",
"localizable":false,
"id":"customLevelSkuProperty",
"order":null
},
{
"itemType":"sku-MensApparel",
"localizedValues":null,
"hidden":false,
"values":[
"Beige",
"Black",
"Blue",
"Brown",
"Camo",
"Dark Worn",
"Gray",
"Green",
"Medium Worn",
"Navy",
"Orange",
"Red",
"Tan",
"White"
],
"length":19,
"variantBasedDisplay":false,
"label":"Color",
"type":"enumerated",
"required":false,
"writable":true,
"uiEditorType":null,
"default":null,
"listingVariant":false,
"propertyType":"variant",
"localizable":false,
"id":"color",
"order":null
},
{
"itemType":"sku-MensApparel",
"localizedValues":null,
"hidden":false,
"values":[
"Small",
"Medium",
"Large",
"X-Large"
],
"length":19,
"variantBasedDisplay":false,
"label":"Size",
"type":"enumerated",
"required":false,
"writable":true,
"uiEditorType":null,
"default":null,
"listingVariant":false,
"propertyType":"variant",
"localizable":false,
"id":"size",
"order":null
}
],
"base":[
{
"itemType":"sku",
"hidden":false,
"length":254,
"variantBasedDisplay":false,
"label":"Name",
"type":"shortText",
"required":false,
"writable":true,
"uiEditorType":null,
"default":null,
"listingVariant":false,
"localizable":true,
"id":"displayName",
"order":"-11"
},
{
"itemType":"sku",
"hidden":false,
"length":165,
"variantBasedDisplay":false,
"label":"Id",
"type":"shortText",
"required":false,
"writable":false,
"uiEditorType":null,
"default":null,
"listingVariant":false,
"localizable":false,
"id":"id",
"order":"-4"
},
{
"itemType":"sku",
"hidden":false,
"length":1,
"variantBasedDisplay":false,
"label":"Active",
"type":"checkbox",
"required":false,
"writable":true,
"uiEditorType":null,
"default":true,
"listingVariant":false,
"localizable":false,
"id":"active",
"order":"50"
},
{
"itemType":"sku",
"hidden":false,
"length":254,
"variantBasedDisplay":false,
"label":"baseLevelSkuProperty",
"type":"shortText",
"required":false,
"writable":true,
"default":null,
"listingVariant":false,
"propertyType":"sku-base",
"localizable":false,
"id":"baseLevelSkuProperty",
"order":null
}
]
}
]
}
Default Response
The error response.
The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud:
|Error Code|Description|
|------------------|------------------|
|33013|Could not find item type|
|20589|Invalid parent type provided.|
|20688|Parent Id does not match Item Type|
Root Schema : errorModel
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
errors(optional):
array errors
An optional list of errors if multiple errors were encountered
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code
-
type(optional):
string
The URI to the HTTP state code definition
Nested Schema : errors
Type:
array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code