# Catalog Items

## List all items for a catalog

> Returns a list of items within a specific catalog with advanced filtering and search.

```json
{"openapi":"3.1.0","info":{"title":"Brand Product Catalogs API","version":"v11"},"servers":[{"url":"https://api.impact.com"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Use your AccountSID as the username and AuthToken as the password."}},"schemas":{"CatalogItem":{"type":"object","properties":{"CatalogItemId":{"type":"string","description":"Unique identifier for the catalog item."},"Name":{"type":"string","description":"Name of the item."},"Description":{"type":"string","description":"Description of the item — information about what it is or what it does."},"CurrentPrice":{"type":"number","description":"Current consumer price of the item."},"OriginalPrice":{"type":"number","description":"Original consumer price of the item."},"Currency":{"type":"string","description":"Currency in which the item's price is listed (ISO 4217)."},"StockAvailability":{"type":"string","enum":["InStock","OutOfStock","BackOrder","PreOrder","LimitedAvailability"],"description":"Status of the product's backstock (`InStock`, `OutOfStock`, `BackOrder`, `PreOrder`, `LimitedAvailability`)."},"Manufacturer":{"type":"string","description":"The person or group that makes the item."},"Url":{"type":"string","description":"URL that leads to the item's online store listing."},"ImageUrl":{"type":"string","description":"URL that leads to the item's image."},"Category":{"type":"string","description":"Group or kind of products with which the item is associated."},"Condition":{"type":"string","description":"Condition the item is in when sold (`New`, `Used`, `Refurbished`, `OEM`, `OpenBox`)."},"Inventory":{"type":"integer","description":"Item's inventory count."},"Uri":{"type":"string","format":"uri-reference","description":"URI that points directly to this catalog item."}}}}},"paths":{"/Advertisers/{AccountSID}/Catalogs/{CatalogId}/Items":{"get":{"operationId":"listCatalogItems","tags":["Catalog Items"],"summary":"List all items for a catalog","description":"Returns a list of items within a specific catalog with advanced filtering and search.","parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"},"description":"Your unique account identifier."},{"name":"CatalogId","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the catalog."},{"name":"Keyword","in":"query","schema":{"type":"string"}},{"name":"Query","in":"query","description":"Complex query string (e.g., CurrentPrice > 10.00 AND Manufacturer = 'Acme'). Eligible fields: `CatalogItemId`, `Name`, `Description`, `Labels`, `Manufacturer`, `CurrentPrice`, `StockAvailability`, `Gtin`, `Category`, `DiscountPercentage`, `Gender`, `Color`, `Size`.","schema":{"type":"string"}},{"name":"PromotionIds","in":"query","description":"Use 'null' to find items with no promotions, or '!=null' for items with promotions.","schema":{"type":"string"}},{"name":"SortBy","in":"query","description":"Sort results by a specific attribute (e.g., 'CurrentPrice'). Eligible fields: `CatalogItemId`, `Name`, `Description`, `Labels`, `Manufacturer`, `CurrentPrice`, `StockAvailability`, `Gtin`, `Category`, `DiscountPercentage`, `Gender`, `Color`, `Size`.","schema":{"type":"string"}}],"responses":{"200":{"description":"A list of items.","content":{"application/json":{"schema":{"type":"object","properties":{"Items":{"type":"array","items":{"$ref":"#/components/schemas/CatalogItem"}}}}}}}}}}}}
```

## Create an item for a catalog

> Creates a new catalog item. Google Merchant Formatting is highly recommended.

```json
{"openapi":"3.1.0","info":{"title":"Brand Product Catalogs API","version":"v11"},"servers":[{"url":"https://api.impact.com"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Use your AccountSID as the username and AuthToken as the password."}},"schemas":{"ItemResponse":{"type":"object","properties":{"Status":{"type":"string"},"Uri":{"type":"string"}}}}},"paths":{"/Advertisers/{AccountSID}/Catalogs/{CatalogId}/Items":{"post":{"operationId":"createCatalogItem","tags":["Catalog Items"],"summary":"Create an item for a catalog","description":"Creates a new catalog item. Google Merchant Formatting is highly recommended.","parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"},"description":"Your unique account identifier."},{"name":"CatalogId","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the catalog."}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["CatalogItemId","Name","Url"],"properties":{"CatalogItemId":{"type":"string"},"Name":{"type":"string"},"Url":{"type":"string"},"Description":{"type":"string"},"CurrentPrice":{"type":"number"},"StockAvailability":{"type":"string","enum":["InStock","OutOfStock","BackOrder","PreOrder","LimitedAvailability"]}}}}}},"responses":{"200":{"description":"Item created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemResponse"}}}}}}}}}
```

## Bulk update items for a catalog

> Update up to 500 products at once using a JSON array.

```json
{"openapi":"3.1.0","info":{"title":"Brand Product Catalogs API","version":"v11"},"servers":[{"url":"https://api.impact.com"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Use your AccountSID as the username and AuthToken as the password."}},"schemas":{"CatalogItem":{"type":"object","properties":{"CatalogItemId":{"type":"string","description":"Unique identifier for the catalog item."},"Name":{"type":"string","description":"Name of the item."},"Description":{"type":"string","description":"Description of the item — information about what it is or what it does."},"CurrentPrice":{"type":"number","description":"Current consumer price of the item."},"OriginalPrice":{"type":"number","description":"Original consumer price of the item."},"Currency":{"type":"string","description":"Currency in which the item's price is listed (ISO 4217)."},"StockAvailability":{"type":"string","enum":["InStock","OutOfStock","BackOrder","PreOrder","LimitedAvailability"],"description":"Status of the product's backstock (`InStock`, `OutOfStock`, `BackOrder`, `PreOrder`, `LimitedAvailability`)."},"Manufacturer":{"type":"string","description":"The person or group that makes the item."},"Url":{"type":"string","description":"URL that leads to the item's online store listing."},"ImageUrl":{"type":"string","description":"URL that leads to the item's image."},"Category":{"type":"string","description":"Group or kind of products with which the item is associated."},"Condition":{"type":"string","description":"Condition the item is in when sold (`New`, `Used`, `Refurbished`, `OEM`, `OpenBox`)."},"Inventory":{"type":"integer","description":"Item's inventory count."},"Uri":{"type":"string","format":"uri-reference","description":"URI that points directly to this catalog item."}}},"ItemResponse":{"type":"object","properties":{"Status":{"type":"string"},"Uri":{"type":"string"}}}}},"paths":{"/Advertisers/{AccountSID}/Catalogs/{CatalogId}/bulkUpdate":{"put":{"operationId":"bulkUpdateCatalogItems","tags":["Catalog Items"],"summary":"Bulk update items for a catalog","description":"Update up to 500 products at once using a JSON array.","parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"},"description":"Your unique account identifier."},{"name":"CatalogId","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the catalog."}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CatalogItem"}}}}},"responses":{"200":{"description":"Bulk update processed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemResponse"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integrations.impact.com/brand-api-reference/brand-api-reference-v11/reference/catalogs/catalog-items.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.