# Exception List Items

## List Items in an Exception List

> Returns a list of all items within a specific exception list.

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Exception Lists","version":"v13"},"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":{"ExceptionListItem":{"type":"object","properties":{"Id":{"type":"integer","description":"The unique identifier for the exception list item."},"Value":{"type":"string","description":"The CATEGORY or SKU value."},"Name":{"type":"string","description":"Display name for the item."},"MatchMode":{"type":"string","description":"How the value is matched against incoming actions.","enum":["EQ","REGEX"]},"ListId":{"type":"integer","description":"The unique identifier of the parent exception list."},"CreatedDate":{"type":"string","format":"date-time","description":"The date and time the item was created."},"Uri":{"type":"string","format":"uri-reference","description":"The unique reference to this item in the impact.com API."}}}}},"paths":{"/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items":{"get":{"summary":"List Items in an Exception List","description":"Returns a list of all items within a specific exception list.","operationId":"listExceptionListItems","tags":["Exception List Items"],"parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"}},{"name":"ExceptionListId","in":"path","required":true,"description":"The unique identifier for the exception list.","schema":{"type":"integer"}},{"name":"Value","in":"query","description":"Filter items by their 'Value' (the specific SKU or Category).","schema":{"type":"string"}}],"responses":{"200":{"description":"A paginated list of exception list item objects.","content":{"application/json":{"schema":{"type":"object","properties":{"ExceptionListItems":{"type":"array","description":"The list of items in this exception list.","items":{"$ref":"#/components/schemas/ExceptionListItem"}}}}}}}}}}}}
```

## Create Items in an Exception List

> Creates one or more new items for an exception list, either via form parameters for a single item or by uploading a file for multiple items.

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Exception Lists","version":"v13"},"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":{"ExceptionListItemCreateForm":{"type":"object","required":["Value"],"properties":{"Value":{"type":"string","description":"The CATEGORY or SKU value."},"Name":{"type":"string","description":"Display name for contracting purposes."},"Upsert":{"type":"boolean","default":false,"description":"If true, updates an existing item with the same 'Value'."}}},"ExceptionListItemCreateFile":{"type":"object","required":["File"],"properties":{"File":{"type":"string","format":"binary","description":"A .CSV or .XLSX file containing the items to be added."},"Upsert":{"type":"boolean","default":false,"description":"If true, updates existing items where 'Value' matches."}}},"SuccessUriResponse":{"type":"object","properties":{"Status":{"type":"string","description":"Indicates whether the operation was successful."},"Uri":{"type":"string","format":"uri-reference","description":"The unique reference to the affected resource."}}}}},"paths":{"/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items":{"post":{"summary":"Create Items in an Exception List","description":"Creates one or more new items for an exception list, either via form parameters for a single item or by uploading a file for multiple items.","operationId":"createExceptionListItems","tags":["Exception List Items"],"parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"}},{"name":"ExceptionListId","in":"path","required":true,"description":"The unique identifier for the exception list.","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/ExceptionListItemCreateForm"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/ExceptionListItemCreateFile"}}},"description":"To create a single item, send `Value` (and optionally `Name`) as `application/x-www-form-urlencoded`.\n\nTo bulk-upload items from a `.csv` or `.xlsx` file, switch the content type to `multipart/form-data` and send the `File` parameter."},"responses":{"200":{"description":"The request was successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessUriResponse"}}}}}}}}}
```

## Delete All Items from an Exception List

> Permanently deletes all items in an exception list. This cannot be undone.

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Exception Lists","version":"v13"},"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."}}},"paths":{"/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items":{"delete":{"summary":"Delete All Items from an Exception List","description":"Permanently deletes all items in an exception list. This cannot be undone.","operationId":"deleteAllExceptionListItems","tags":["Exception List Items"],"parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"}},{"name":"ExceptionListId","in":"path","required":true,"description":"The unique identifier for the exception list.","schema":{"type":"integer"}}],"responses":{"200":{"description":"All items were deleted successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"Status":{"type":"string","description":"Indicates that the resource was deleted."}}}}}}}}}}}
```

## Replace All Items in an Exception List

> Replaces all items within an existing exception list by uploading a new .CSV or .XLSX file.

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Exception Lists","version":"v13"},"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":{"SuccessUriResponse":{"type":"object","properties":{"Status":{"type":"string","description":"Indicates whether the operation was successful."},"Uri":{"type":"string","format":"uri-reference","description":"The unique reference to the affected resource."}}}}},"paths":{"/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items":{"patch":{"summary":"Replace All Items in an Exception List","description":"Replaces all items within an existing exception list by uploading a new .CSV or .XLSX file.","operationId":"replaceExceptionListItems","tags":["Exception List Items"],"parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"}},{"name":"ExceptionListId","in":"path","required":true,"description":"The unique identifier for the exception list.","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["File"],"properties":{"File":{"type":"string","format":"binary","description":"A .CSV or .XLSX file containing the new items."}}}}}},"responses":{"200":{"description":"The request was successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessUriResponse"}}}}}}}}}
```

## Get Exception List Item Details

> Retrieves the details of a single item from an exception list.

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Exception Lists","version":"v13"},"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":{"ExceptionListItem":{"type":"object","properties":{"Id":{"type":"integer","description":"The unique identifier for the exception list item."},"Value":{"type":"string","description":"The CATEGORY or SKU value."},"Name":{"type":"string","description":"Display name for the item."},"MatchMode":{"type":"string","description":"How the value is matched against incoming actions.","enum":["EQ","REGEX"]},"ListId":{"type":"integer","description":"The unique identifier of the parent exception list."},"CreatedDate":{"type":"string","format":"date-time","description":"The date and time the item was created."},"Uri":{"type":"string","format":"uri-reference","description":"The unique reference to this item in the impact.com API."}}}}},"paths":{"/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items/{ItemId}":{"get":{"summary":"Get Exception List Item Details","description":"Retrieves the details of a single item from an exception list.","operationId":"getExceptionListItemById","tags":["Exception List Items"],"parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"}},{"name":"ExceptionListId","in":"path","required":true,"schema":{"type":"integer"}},{"name":"ItemId","in":"path","required":true,"description":"The unique identifier for the exception list item.","schema":{"type":"integer"}}],"responses":{"200":{"description":"A single exception list item object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExceptionListItem"}}}}}}}}}
```

## Delete an Exception List Item

> Permanently deletes a single item from an exception list. This cannot be undone.

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Exception Lists","version":"v13"},"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."}}},"paths":{"/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items/{ItemId}":{"delete":{"summary":"Delete an Exception List Item","description":"Permanently deletes a single item from an exception list. This cannot be undone.","operationId":"deleteExceptionListItem","tags":["Exception List Items"],"parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"}},{"name":"ExceptionListId","in":"path","required":true,"schema":{"type":"integer"}},{"name":"ItemId","in":"path","required":true,"description":"The unique identifier for the exception list item.","schema":{"type":"integer"}}],"responses":{"200":{"description":"The item was deleted successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"Status":{"type":"string","description":"Indicates that the resource was deleted."}}}}}}}}}}}
```


---

# 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-v13/reference/exception-lists/exception-list-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.