Category List Input
Input representation of the request to get a list of categories.
This example shows a sample request to get a list of categories with eligible promotions.
| Name | Type | Description | Required or Optional | Available Version |
|---|---|---|---|---|
additionalContextData | Context Data Input[] | Additional nodes that are added to the custom or default context definition. The maximum number of supported nodes is 10. | Optional | 60.0 |
catalogId | String | ID of the catalog. | Required | 60.0 |
contextDefinition | String | API name of the custom context definition that’s sent for context creation. If this property isn’t specified, then the default context definition is used. | Optional | 60.0 |
contextMapping | String | Default context mapping of the context definition. If a context mapping is specified, then the API checks whether the mapping belongs to the specified context definition to process the details for hydration. | Optional | 60.0 |
correlationId | String | Unique identifier value that’s attached to the requests and messages, and accepts references to a particular transaction or event chain. | Optional | 60.0 |
customFields | String[] | List of additional custom fields to include in the response. | Optional | 60.0 |
depth | Integer | Specifies the levels of subcategories to retrieve beneath the parent category. This parameter only applies when parentCategoryId is provided. | Optional | 61.0 |
enableQualification | Boolean | Indicates whether to enable qualification rules for the products (true) or not (false). The default value is true. | Optional | 60.0 |
filter | Filter Input | Filters records based on supported criteria. The supported property is isQualified. | Optional | 62.0 |
parentCategoryId | String | ID of the parent category whose subcategories you want to retrieve. If not specified, only root-level categories from the catalog are returned. | Optional | 61.0 |
qualificationProcedure | String | API name of the custom qualification procedure that’s used for the product qualification process. If this property isn’t specified, then the default qualification procedure is executed. | Optional | 60.0 |
usePromotions | Boolean | Indicates whether to fetch eligible promotions from Global Promotion Management (GPM) for the requested category and its products (true) or not (false). If Promotion feature is enabled in the org and this property isn’t specified, then the default value is true. If the Promotion feature isn’t enabled, the default value is false. | Optional | 66.0 |
userContext | User Context Input | User context details. For example, account ID or contact ID. | Optional | 60.0 |
The supported operators are:
eqincontains—This value isn’t applicable if the Use Indexed Data For Product Listing and Search toggle from the Product Discovery Settings page from Setup is enabled.