listCollections
get
/ccadmin/v1/collections
List Collections. Get a list of collections.
Use the name query param to list the collections whose display name CONTAINS IGNORECASE the given search string. Use the categoryIds param to get a list of collections whose ids match those listed in the comma delimted string value. Either categoryIds or name must be provided.
Optionally takes the x-ccasset-language header to get translated content in another language.
To get the list of included/excluded collections, use a group of {promotionId, itemTypeList and templateValue} parameters together.
Request
Supported Media Types
- application/json
Query Parameters
-
asHierarchy(optional): boolean
This is a v1 catalog compatibility flag which will return a hierarchy for use in such places as a collection tree. Default is false. This is cannot be used with pageResults.
-
catalogId(optional): string
ID of catalog.
-
categoryIds(optional): string
List of collection ids to get.
-
continueOnMissingCategory(optional): boolean
boolean flag to determine whether to continue if a category is missing.
-
depth(optional): string
Depth of nested response from 0 to 6. Defaults to 1, however if categoryIds are specified then defaults to 4. NOTE: Caution should be used as increasing depth can negatively affect performance.
-
filterRootCategories(optional): boolean
boolean flag to determine whether to filter root categories from the results.
-
itemTypeList(optional): string
Type of collections list associated with the given promotion id -includedCategories or excludedCategories
- minimalFieldsForNavigation(optional): boolean
-
multipleCategoryPaths(optional): boolean
This parameter is dependent on showCategoryPaths set to true. If the value is set to true then response returns multiCatalogCategoryPaths and multiCatalogCategoryIdPaths to display linked paths from multiple catalogs prepended with catalog name and id respectively. Its behavior is Default value of the parameter is false.
-
name: string
Partial display name or id of a collection.
-
onlyActive(optional): boolean
Only return active categories when it is true, when set to false or by default, returns all the categories
-
orphaned(optional): boolean
boolean flag if true all unassigned (orphaned) collections are returned.
-
pageResults(optional): boolean
Return response with paginated pattern
-
promotionId(optional): string
The promotion id for the included/excluded collection list. If promotionId is included then include the itemTypeList and templateValue parameters to get the include/exclude collection list for the promotion
-
q(optional): string
A SCIM filter string for selecting a subset of all collections. See [https://tools.ietf.org/html/draft-ietf-scim-api-12#section-3.2.2](https://tools.ietf.org/html/draft-ietf-scim-api-12#section-3.2.2)section 3.2.2.2 of the SCIM specification for details on the SCIM filter format . Examples: Get all collections whose displayName contains shirt: q=displayName co "shirt" Get all child collections for collection with id shoes: q=fixedParentCategories co "shoes" Text, date and time values appearing in SCIM filters should be quoted, with date and time values using ISO-8601 format. Numeric and boolean values should not be quoted. The following collection properties can be used in a q query: * categoryImages * creationDate * description * displayName * fixedParentCategories * id * longDescription * fixedChildProducts
-
showAccessControlInfo(optional): boolean
Boolean flag to determine whether to show currently logged in user's access control information for the categories in the response. Default value is false.
-
showCatalogsCount(optional): boolean
Boolean flag to determine whether to show or hide catalogsCount property in the response. Default value is false.
-
showCategoryPaths(optional): boolean
If set to false then category path related properties, namely, categoryPaths, categoryIdPaths, multiCatalogCategoryPaths and multiCatalogCategoryIdPaths, are not returned. If set to true then categoryPaths and categoryIdPaths are returned. For multiCatalogCategoryPaths and multiCatalogCategoryIdPaths use multipleCategoryPaths parameter. Default value of the parameter is true.
-
templateValue(optional): string
UI Template value associated with the included/excluded collections list - e.g PSC_Value
-
useExplicitActiveState(optional): boolean
Only return categories that do not inherit their active state from their parent categories. This can be used in combination with the onlyActive query parameter to ensure only explicitly active/inactive categories are returned. Note: Restricting the results to explicit active state allows the query to include the active state and return a full page of categories rather than post active filtering of categories which can return partial result pages.
Header Parameters
-
X-CCAsset-Language(optional): string
The asset language of the request
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Root Schema : listCollections_response
Type:
Show Source
object
-
items(optional):
array items
The array of collection items.
-
limit(optional):
integer
Limit of number of collections.
-
offset(optional):
integer
Offset of collection inventory.
-
sort(optional):
array sort
List of properties being sorted.
-
total(optional):
integer
Total number of collections.
-
totalResults(optional):
integer
Total number of collections.
Nested Schema : items
Type:
Show Source
object
-
active(optional):
boolean
Whether or not the category is active
-
catalogsCount(optional):
integer
Number of catalogs this category is associated to.
-
categoryImages(optional):
array categoryImages
The category images.
-
categoryPaths(optional):
array categoryPaths
An array of category paths.
-
childCategories(optional):
array childCategories
Array of category objects.
-
childProducts(optional):
array childProducts
Array of product objects. Note, if the catalogId is a filtered view catalog then this will only include the products in that filtered view catalog.
-
childProductsCount(optional):
integer
Count of the child products.
-
creationDate(optional):
string
Creation date of the category.
-
description(optional):
string
Description of the category.
-
displayName(optional):
string
Display Name of the category.
-
fixedParentCategories(optional):
array fixedParentCategories
Array of category objects.
-
id(optional):
string
Category ID.
-
longDescription(optional):
string
Long description of the category.
-
multiCatalogCategoryIdPaths(optional):
array multiCatalogCategoryIdPaths
An array of category ids in the path prepended with catalog id
-
multiCatalogCategoryPaths(optional):
array multiCatalogCategoryPaths
An array of category paths prepended with catalog name
-
parentCategory(optional):
object parentCategory
Default parent category
-
repositoryId(optional):
string
Repository ID of the category.
-
route(optional):
string
Route of the category.
Nested Schema : childProducts
Type:
array
Array of product objects. Note, if the catalogId is a filtered view catalog then this will only include the products in that filtered view catalog.
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 category
Show Source
-
repositoryId(optional):
string
Repository id of the default parent category
Nested Schema : items
Type:
Show Source
object
-
repositoryId(optional):
string
The repository Id of the category image.
Nested Schema : items
Type:
Show Source
object
-
catalogsCount(optional):
integer
Number of catalogs this category is associated to.
-
repositoryId(optional):
string
The repository Id of the child category
Nested Schema : items
Type:
Show Source
object
-
repositoryId(optional):
The repository Id of the child product
Nested Schema : items
Type:
Show Source
object
-
repositoryId(optional):
string
The repository Id of the categories
Nested Schema : items
Type:
Show Source
object
-
order(optional):
string
The order by which the property is sorted.
-
property(optional):
string
The property being sorted.
Example Response (application/json)
{
"total":1,
"totalResults":1,
"offset":0,
"limit":250,
"sort":[
{
"property":"displayName",
"order":"asc"
}
],
"items":[
{
"longDescription":"Looking for an inspired quality gift? ATG Store gift shop has a wide choice of gifts for both men and women suitable for every occassion. Shopping for gifts is simple and convenient at ATG Store.com.",
"childProducts":null,
"catalogsCount":2,
"categoryPaths":[
"/Commerce Root/Gift Shop"
],
"displayName":"Gift Shop",
"active":false,
"childCategories":[
{
"longDescription":"Looking for gift ideas for him? Let us help you find that perfect gift for him at ATG Store. Shopping for gifts is simple and convenient at ATG Store.com.",
"route":"/for-him/category/cat50067",
"categoryPaths":[
"/Commerce Root/Gift Shop/For Him"
],
"displayName":"For Him",
"repositoryId":"cat50067",
"active":false,
"childCategories":null,
"id":"cat50067",
"fixedParentCategories":[
{
"repositoryId":"cat50056"
}
]
}
],
"creationDate":"2017-01-09T05:09:29.000Z",
"route":"/gift-shop/category/cat50056",
"repositoryId":"cat50056",
"multiCatalogCategoryPaths":[
"CloudLake Catalog/Commerce Root/Gift Shop"
],
"parentCategory":{
"repositoryId":"cat50097"
},
"multiCatalogCategoryIdPaths":[
"cloudLakeCatalog:rootCategory>cat50056"
]
}
]
}
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|
|------------------|------------------|
|21169|invalid template value incorrect_value.|
|21168|templateValue is a required property for this request|
|21167|itemTypeList is a required property for this request|
|21001|Promotion not found for the given id: invalidId|
|20142|Get Category Id Type Internal Error|
|21165|itemTypeList can either be includedCategories or excludedCategories for this request|
|20053|The collection view does not support queries containing parameters|
|20052|Get List Collections Type Internal Error|
|20140|Collection Id is invalid or non-existent|
|84000|Conflicting query parameters|
|21170|promotionId is a required property for this request|
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