getCollection

get

/ccstore/v1/collections/{id}

Get Collection. Get a collection by ID. 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. If 'rootCategory' is passed as a category id, actual root category of the catalog is picked up and considered.

Request

Supported Media Types
Path Parameters
Query Parameters
  • ID of the catalog.
  • False indicates category details are not returned if there are no active products under the category. True indicates category details are returned irrespective of the active products availability.
  • If set to childCategories, then child categories will be expanded to include details, if there are any active products under it. disableActiveProdCheck can be set to true in case the category details are needed irrespective of active products are available.
  • Maximum level of depth for child categories.
  • Return multiCatalogCategoryPaths and multiCatalogCategoryIdPaths to display linked paths from multiple catalogs prepended with catalog name and id respectively if the value is set to true. Default value of the parameter is false.
Header Parameters
Back to Top

Response

Supported Media Types

200 Response

Following model is returned when operation succeeds.
Body ()
Root Schema : getCollection_response
Type: object
Show Source
Nested Schema : ancestorCategories
Type: array
Array of category objects.
Show Source
Nested Schema : categoryImages
Type: array
Array of category images.
Show Source
Nested Schema : categoryPaths
Type: array
Array of category paths.
Show Source
Nested Schema : childCategories
Type: array
Array of category objects.
Show Source
Nested Schema : childProducts
Type: array
Array of child products.
Show Source
Nested Schema : fixedChildCategories
Type: array
Array of category objects.
Show Source
Nested Schema : fixedParentCategories
Type: array
Array of category objects.
Show Source
Nested Schema : keywords
Type: array
Array of keywords.
Show Source
Nested Schema : multiCatalogCategoryIdPaths
Type: array
An array of category ids in the path prepended with catalog id
Show Source
Nested Schema : multiCatalogCategoryPaths
Type: array
An array of category paths prepended with catalog name
Show Source
Nested Schema : parentCategory
Type: object
Default parent collection of the product.
Show Source
Nested Schema : seoMetaInfo
Type: object
Seo meta info for category.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : metadata
Type: object
Seo meta info for category.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Example Response (application/json)
{
    "items":[
        {
            "longDescription":null,
            "route":"/for-him/category/cat50067",
            "displayName":"For Him",
            "childCategories":[
                {
                    "longDescription":null,
                    "route":"/under-$25/category/cat90042",
                    "displayName":"Under $25",
                    "id":"cat90042",
                    "creationDate":"2011-01-07T17:19:47.000Z"
                },
                {
                    "longDescription":null,
                    "route":"/under-$50/category/cat90040",
                    "displayName":"Under $50",
                    "id":"cat90040",
                    "creationDate":"2011-01-07T17:19:47.000Z"
                }
            ],
            "id":"cat50067",
            "creationDate":"2011-01-07T17:19:47.000Z"
        },
        {
            "longDescription":null,
            "route":"/for-her/category/cat60001",
            "displayName":"For Her",
            "childCategories":[
                {
                    "longDescription":null,
                    "route":"/under-$25/category/cat90046",
                    "displayName":"Under $25",
                    "id":"cat90046",
                    "creationDate":"2011-01-07T17:19:47.000Z"
                },
                {
                    "longDescription":null,
                    "route":"/under-$50/category/cat90026",
                    "displayName":"Under $50",
                    "id":"cat90026",
                    "creationDate":"2011-01-07T17:19:47.000Z"
                },
                {
                    "longDescription":null,
                    "route":"/for-the-romantic/category/cat90028",
                    "displayName":"For the Romantic",
                    "id":"cat90028",
                    "creationDate":"2011-01-07T17:19:47.000Z"
                },
                {
                    "longDescription":null,
                    "route":"/for-the-fashionista/category/cat90037",
                    "displayName":"For the Fashionista",
                    "id":"cat90037",
                    "creationDate":"2011-01-07T17:19:47.000Z"
                },
                {
                    "longDescription":null,
                    "route":"/for-the-outdoor-lover/category/cat90034",
                    "displayName":"For the Outdoor Lover",
                    "id":"cat90034",
                    "creationDate":"2011-01-07T17:19:47.000Z"
                }
            ],
            "id":"cat60001",
            "creationDate":"2011-01-07T17:19:47.000Z"
        }
    ]
}

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