> For the complete documentation index, see [llms.txt](https://integrations.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integrations.impact.com/brand-api-reference/reference/exception-lists/exception-list-items.md).

# 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":"v14"},"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":"v14"},"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":"v14"},"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":"v14"},"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":"v14"},"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":"v14"},"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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://integrations.impact.com/brand-api-reference/reference/exception-lists/exception-list-items.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.