1. REST API for Oracle Commerce Cloud 21C
  2. Tasks
  3. Store
  4. Products

listProducts

get

/ccstore/v1/products

List Products. Get a list of products. Optionally takes the x-ccasset-language headers to get translated content in another language.Also it can have optional X-CCOrganization header which is a JSON field to specify current Organization id of logged in user. None of the image URLS are encoded.

Request

Supported Media Types
Query Parameters
Header Parameters
Back to Top

Response

Supported Media Types

200 Response

Following model is returned when operation succeeds.
Body ()
Root Schema : listProducts_response
Type: object
Show Source
Nested Schema : items
Type: object
Images and urls of the product. Image Urls are not encoded.
Show Source
Nested Schema : sort
Type: object
Sorting criteria of the products.
Show Source
Nested Schema : addOnProducts
Type: array
List of add-on products associated with the product
Show Source
Nested Schema : childSKUs
Type: array
List of SKU's for the product.
Show Source
Nested Schema : fullImageURLs
Type: array
The array of full image URLs. Urls are not encoded.
Show Source
Nested Schema : largeImageURLs
Type: array
The array of large image URLs. Urls are not encoded.
Show Source
Nested Schema : listPrices
Type: object
list prices of the SKU in respective price list groups
Show Source
Nested Schema : mediumImageURLs
Type: array
The url of the medium image. Url is not encoded.
Show Source
Nested Schema : productVariantOptions
Type: array
Objects containing product's variant options details if available for the product.
Show Source
Nested Schema : salePrices
Type: object
sale prices of the product in respective price list groups
Show Source
Nested Schema : shippingSurcharges
Type: object
Extra handling costs for shipping the product in respective price list groups
Show Source
Nested Schema : smallImage
Type: array
The array of small image URLs. Urls are not encoded.
Show Source
Nested Schema : smallImageURLs
Type: array
The urls of the small image.Urls are not encoded.
Show Source
Nested Schema : sourceImageURLs
Type: array
The array of source image URLs. Urls are not encoded.
Show Source
Nested Schema : thumbImageURLs
Type: array
The array of thumbnail image URLs. Urls are not encoded.
Show Source
Nested Schema : variantValuesOrder
Type: object
Object having various variant property as key and ordered values array as the value.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : addOnOptions
Type: array
List of options within a configurable Property
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : product
Type: object
The add-on product associated with product
Show Source
Nested Schema : sku
Type: object
The add-on sku associated with product
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : configurationMetadata
Type: array
Array of configuration attributes associated with the SKU.
Show Source
Nested Schema : fullImageURLs
Type: array
Full Image URLs of SKU.
Show Source
Nested Schema : largeImageURLs
Type: array
Large Image URLs of SKU.
Show Source
Nested Schema : listPrices
Type: object
list prices of the product in respective price list groups
Show Source
Nested Schema : mediumImageURLs
Type: array
Medium Image URLs SKU.
Show Source
Nested Schema : salePrices
Type: object
sale prices of the product in respective price list groups
Show Source
Nested Schema : shippingSurcharges
Type: object
Extra handling costs for shipping the product in respective price list groups
Show Source
Nested Schema : smallImageURLs
Type: array
Small Image URLs of SKU.
Show Source
Nested Schema : sourceImageURLs
Type: array
Source Image URLs of SKU.
Show Source
Nested Schema : thumbImageURLs
Type: array
Thumb Image URLs of SKU.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : optionValueMap
Type: object
Additional Properties Allowed
Show Source
mapping of all option values with corresponding option value ids
Show Source
Example Response (application/json)
{
    "total":92,
    "totalResults":92,
    "totalExpandedResults":92,
    "limit":250,
    "sort":[
        {
            "property":"displayName",
            "order":"asc"
        }
    ],
    "items":[
        {
            "longDescription":"It's Samantha Baker's Sweet Sixteen and no one in her family remembers\n                the important occasion. John Hughes, the writer of National Lampoon's Vacation, shows how coming-of-age\n                can be full of surprises in this warm-hearted teenage comedy starring Molly Ringwald. She's your average\n                teen, enduring creepy freshmen, spoiled siblings, confused parents and the Big Blonde on Campus who\n                stands between her and the boy of her dreams. But wait...the day isn't over yet! This sparkling film\n                features a dynamic score, and outstanding performances by Paul Dooley, Emmy winner Blanche Baker and\n                Oscar nominee Justin Henry.\n            ",
            "primaryThumbImageURL":"/ccstore/v1/images/?source=http://localhost:8080/file/qaimg/products/sixteen_candles_LARGE.jpg&height=100&width=100",
            "largeImage":null,
            "smallImage":null,
            "nonreturnable":false,
            "displayName":"16 Candles",
            "orderLimit":null,
            "description":"A really great movie that you should not miss.",
            "onlineOnly":true,
            "primaryFullImageURL":"/ccstore/v1/images/?source=http://localhost:8080/file/qaimg/products/sixteen_candles_LARGE.jpg",
            "listPrices":null,
            "salePrices":null,
            "productVariantOptions":[
                {
                    "listingVariant":false,
                    "optionValueMap":{
                        "Silver":1,
                        "Neon":2,
                        "Black":0
                    },
                    "variantBasedDisplay":false,
                    "optionId":"color",
                    "mapKeyPropertyAttribute":"sku-camcorder_color",
                    "optionName":"color"
                }
            ],
            "largeImageURLs":[
                "/ccstore/v1/images/?source=http://localhost:8080/file/qaimg/products/sixteen_candles_LARGE.jpg&height=940&width=940"
            ],
            "primaryLargeImageURL":"/ccstore/v1/images/?source=http://localhost:8080/file/qaimg/products/sixteen_candles_LARGE.jpg&height=940&width=940",
            "addOnProducts":[
                {
                    "repositoryId":"cp10003",
                    "addOnOptions":[
                        {
                            "product":{
                                "displayName":"Birthday Gift Wrap",
                                "repositoryId":"BirthdayGiftWrap",
                                "active":true
                            },
                            "repositoryId":"co10005",
                            "sku":{
                                "displayName":"option1",
                                "repositoryId":"option1",
                                "active":true
                            }
                        },
                        {
                            "product":{
                                "displayName":"Birthday Gift Wrap",
                                "repositoryId":"BirthdayGiftWrap",
                                "active":true
                            },
                            "repositoryId":"co10006",
                            "sku":{
                                "displayName":"option2",
                                "repositoryId":"option2",
                                "active":true
                            }
                        }
                    ]
                }
            ],
            "derivedShippingSurchargeFrom":"defaultPriceGroup",
            "smallImageURLs":[
                "/ccstore/v1/images/?source=http://localhost:8080/file/qaimg/products/sixteen_candles_LARGE.jpg&height=300&width=300"
            ],
            "derivedSalePriceFrom":"defaultPriceGroup",
            "shippingSurcharges":null,
            "id":"Product_19Cxy",
            "childSKUs":[
                {
                    "dynamicPropertyMapLong":{
                    },
                    "primaryThumbImageURL":null,
                    "largeImage":null,
                    "smallImage":null,
                    "nonreturnable":false,
                    "listPrices":null,
                    "salePrices":null,
                    "primaryFullImageURL":null,
                    "configurationMetadata":[
                    ],
                    "productListingSku":null,
                    "largeImageURLs":[
                    ],
                    "primaryLargeImageURL":null,
                    "derivedOnlineOnly":true,
                    "smallImageURLs":[
                    ],
                    "derivedSalePriceFrom":"defaultPriceGroup",
                    "shippingSurcharges":null,
                    "thumbnailImage":null,
                    "salePriceEndDate":null,
                    "salePriceStartDate":null,
                    "images":[
                    ],
                    "salePrice":4.99,
                    "primaryMediumImageURL":null,
                    "fullImageURLs":[
                    ],
                    "active":true,
                    "thumbImageURLs":[
                    ],
                    "mediumImageURLs":[
                    ],
                    "derivedListPriceFrom":"defaultPriceGroup",
                    "repositoryId":"Sku_19Dxy",
                    "DynamicSkuProperty2":"value2",
                    "shippingSurcharge":null,
                    "primarySourceImageURL":null,
                    "DynamicSkuProperty1":"value1",
                    "primarySmallImageURL":null,
                    "sourceImageURLs":[
                    ],
                    "listPrice":12.99
                },
                {
                    "dynamicPropertyMapLong":{
                    },
                    "salePriceStartDate":null,
                    "largeImage":null,
                    "smallImage":null,
                    "salePrice":null,
                    "nonreturnable":false,
                    "active":true,
                    "listPrices":null,
                    "salePrices":null,
                    "configurationMetadata":[
                    ],
                    "derivedSalePriceFrom":"defaultPriceGroup",
                    "derivedListPriceFrom":"defaultPriceGroup",
                    "shippingSurcharges":null,
                    "repositoryId":"Sku_19Dxyi",
                    "shippingSurcharge":10,
                    "thumbnailImage":null,
                    "salePriceEndDate":null,
                    "listPrice":null
                },
                {
                    "dynamicPropertyMapLong":{
                    },
                    "salePriceStartDate":null,
                    "largeImage":null,
                    "smallImage":null,
                    "salePrice":8.99,
                    "nonreturnable":false,
                    "active":true,
                    "listPrices":null,
                    "salePrices":null,
                    "configurationMetadata":[
                    ],
                    "derivedSalePriceFrom":"defaultPriceGroup",
                    "derivedListPriceFrom":"defaultPriceGroup",
                    "shippingSurcharges":null,
                    "repositoryId":"Sku_19Dxyii",
                    "shippingSurcharge":null,
                    "thumbnailImage":null,
                    "salePriceEndDate":null,
                    "listPrice":19.99
                }
            ],
            "salePrice":8.99,
            "primaryMediumImageURL":"/ccstore/v1/images/?source=http://localhost:8080/file/qaimg/products/sixteen_candles_LARGE.jpg&height=475&width=475",
            "fullImageURLs":[
                "/ccstore/v1/images/?source=http://localhost:8080/file/qaimg/products/sixteen_candles_LARGE.jpg"
            ],
            "active":true,
            "thumbImageURLs":[
                "/ccstore/v1/images/?source=http://localhost:8080/file/qaimg/products/sixteen_candles_LARGE.jpg&height=100&width=100"
            ],
            "creationDate":"2014-10-27T05:11:57.034Z",
            "variantValuesOrder":{
                "color":[
                    "Spring Green",
                    "Cranberry",
                    "Marigold"
                ],
                "size":[
                    "Small",
                    "Large",
                    "Medium"
                ]
            },
            "route":"/16-candles/product/Product_19Cxy",
            "mediumImageURLs":[
                "/ccstore/v1/images/?source=http://localhost:8080/file/qaimg/products/sixteen_candles_LARGE.jpg&height=475&width=475"
            ],
            "derivedListPriceFrom":"defaultPriceGroup",
            "repositoryId":"Product_19Cxy",
            "primarySourceImageURL":"/ccstore/v1/images/?source=http://localhost:8080/file/qaimg/products/sixteen_candles_LARGE.jpg&height=300&width=300",
            "shippingSurcharge":20,
            "primarySmallImageURL":"/ccstore/v1/images/?source=http://localhost:8080/file/qaimg/products/sixteen_candles_LARGE.jpg&height=300&width=300",
            "sourceImageURLs":[
                "/ccstore/v1/images/?source=http://localhost:8080/file/qaimg/products/sixteen_candles_LARGE.jpg&height=300&width=300"
            ],
            "avgCustRating":4.5,
            "listPrice":19.99
        }
    ]
}

Default Response

The error response
Body ()
Root Schema : errorModel
Type: object
Show Source
Nested Schema : errors
Type: array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top