> 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/general-exception-lists/general-exception-list-items.md).

# General Exception List Items

## List Items in a General Exception List

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

```json
{"openapi":"3.1.0","info":{"title":"Brand API - General Exception Lists","version":"v14"},"servers":[{"url":"https://api.impact.com"}],"paths":{"/Advertisers/{AccountSID}/GeneralExceptionLists/{ListId}/Items":{"get":{"summary":"List Items in a General Exception List","description":"Returns a list of all items within a specific general exception list.","operationId":"listGeneralExceptionListItems","tags":["General Exception List Items"],"parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"}},{"name":"ListId","in":"path","required":true,"description":"The unique identifier for the general exception list.","schema":{"type":"integer"}},{"name":"Value","in":"query","description":"Filter items by their 'Value'.","schema":{"type":"string"}}],"responses":{"200":{"description":"A list of general exception list item objects.","content":{"application/json":{"schema":{"type":"object","properties":{"GeneralExceptionListItems":{"type":"array","description":"The list of items in this general exception list.","items":{"$ref":"#/components/schemas/GeneralExceptionListItem"}}}}}}}}}}},"components":{"schemas":{"GeneralExceptionListItem":{"type":"object","properties":{"Id":{"type":"integer","description":"The unique identifier for the general exception list item."},"Value":{"type":"string","description":"The attribute value to match against incoming actions (e.g. a city name, currency code, or custom identifier)."},"Name":{"type":"string","description":"Display name for the item. Returned as an empty string when not set."},"MatchMode":{"type":"string","description":"How the value is matched against incoming actions. Unlike standard Exception Lists, this cannot be controlled when creating or updating items — general exception list items are always an implicit EQ match.","enum":["EQ"]},"ListId":{"type":"integer","description":"The unique identifier of the parent general exception list."},"CreatedDate":{"type":"string","description":"The date and time the item was created, in ISO 8601 format. Observed to sometimes be returned as an empty string on the single-item GET even when populated on the list endpoint."},"Uri":{"type":"string","format":"uri-reference","description":"The unique reference to this item in the impact.com API."}}}}}}
```

## Create Items in a General Exception List

> Creates one or more new items for a general 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 - General Exception Lists","version":"v14"},"servers":[{"url":"https://api.impact.com"}],"paths":{"/Advertisers/{AccountSID}/GeneralExceptionLists/{ListId}/Items":{"post":{"summary":"Create Items in a General Exception List","description":"Creates one or more new items for a general exception list, either via form parameters for a single item or by uploading a file for multiple items.","operationId":"createGeneralExceptionListItems","tags":["General Exception List Items"],"parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"}},{"name":"ListId","in":"path","required":true,"description":"The unique identifier for the general exception list.","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/GeneralExceptionListItemCreate"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/GeneralExceptionListItemCreateFile"}}},"description":"To create a single item, send `Value` (and optionally `Name`) as `application/x-www-form-urlencoded`. The response `Uri` points at the newly created item.\n\nTo bulk-upload items from a `.csv` or `.xlsx` file, switch the content type to `multipart/form-data` and send the `File` parameter. Uploaded items are appended to the list, and the response `Uri` points at the items collection rather than an individual item."},"responses":{"200":{"description":"The request was successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessUriResponse"}}}}}}}},"components":{"schemas":{"GeneralExceptionListItemCreate":{"type":"object","required":["Value"],"properties":{"Value":{"type":"string","description":"The attribute value to match against incoming actions."},"Name":{"type":"string","description":"Display name for the item."},"Upsert":{"type":"boolean","default":false,"description":"If true, updates an existing item with the same 'Value' instead of creating a duplicate."}}},"GeneralExceptionListItemCreateFile":{"type":"object","required":["File"],"properties":{"File":{"type":"string","format":"binary","description":"A .CSV or .XLSX file containing the items to be added, with 'Value' and 'Name' columns. The UI enforces a 5 MB limit before upload; whether the API enforces this independently has not been confirmed (a 5.2 MB file was accepted via the PATCH replace-items operation in testing)."},"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."}}}}}}
```

## Delete All Items from a General Exception List

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

```json
{"openapi":"3.1.0","info":{"title":"Brand API - General Exception Lists","version":"v14"},"servers":[{"url":"https://api.impact.com"}],"paths":{"/Advertisers/{AccountSID}/GeneralExceptionLists/{ListId}/Items":{"delete":{"summary":"Delete All Items from a General Exception List","description":"Permanently deletes all items in a general exception list. This cannot be undone.","operationId":"deleteAllGeneralExceptionListItems","tags":["General Exception List Items"],"parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"}},{"name":"ListId","in":"path","required":true,"description":"The unique identifier for the general 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 a General Exception List

> Replaces all items within an existing general exception list by uploading a new .CSV or .XLSX file. The impact.com UI blocks files of 5 MB or larger before upload, but this was not reproduced on the API directly — a 5.2 MB (210,000-row) file was accepted and fully processed in testing.

```json
{"openapi":"3.1.0","info":{"title":"Brand API - General Exception Lists","version":"v14"},"servers":[{"url":"https://api.impact.com"}],"paths":{"/Advertisers/{AccountSID}/GeneralExceptionLists/{ListId}/Items":{"patch":{"summary":"Replace All Items in a General Exception List","description":"Replaces all items within an existing general exception list by uploading a new .CSV or .XLSX file. The impact.com UI blocks files of 5 MB or larger before upload, but this was not reproduced on the API directly — a 5.2 MB (210,000-row) file was accepted and fully processed in testing.","operationId":"replaceGeneralExceptionListItems","tags":["General Exception List Items"],"parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"}},{"name":"ListId","in":"path","required":true,"description":"The unique identifier for the general 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. The UI enforces a 5 MB limit before upload; the API itself accepted a 5.2 MB file in testing, so this does not appear to be enforced server-side."}}}}}},"responses":{"200":{"description":"The request was successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessUriResponse"}}}}}}}},"components":{"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."}}}}}}
```

## Get General Exception List Item Details

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

```json
{"openapi":"3.1.0","info":{"title":"Brand API - General Exception Lists","version":"v14"},"servers":[{"url":"https://api.impact.com"}],"paths":{"/Advertisers/{AccountSID}/GeneralExceptionLists/{ListId}/Items/{ItemId}":{"get":{"summary":"Get General Exception List Item Details","description":"Retrieves the details of a single item from a general exception list.","operationId":"getGeneralExceptionListItemById","tags":["General Exception List Items"],"parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"}},{"name":"ListId","in":"path","required":true,"schema":{"type":"integer"}},{"name":"ItemId","in":"path","required":true,"description":"The unique identifier for the general exception list item.","schema":{"type":"integer"}}],"responses":{"200":{"description":"A single general exception list item object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneralExceptionListItem"}}}}}}}},"components":{"schemas":{"GeneralExceptionListItem":{"type":"object","properties":{"Id":{"type":"integer","description":"The unique identifier for the general exception list item."},"Value":{"type":"string","description":"The attribute value to match against incoming actions (e.g. a city name, currency code, or custom identifier)."},"Name":{"type":"string","description":"Display name for the item. Returned as an empty string when not set."},"MatchMode":{"type":"string","description":"How the value is matched against incoming actions. Unlike standard Exception Lists, this cannot be controlled when creating or updating items — general exception list items are always an implicit EQ match.","enum":["EQ"]},"ListId":{"type":"integer","description":"The unique identifier of the parent general exception list."},"CreatedDate":{"type":"string","description":"The date and time the item was created, in ISO 8601 format. Observed to sometimes be returned as an empty string on the single-item GET even when populated on the list endpoint."},"Uri":{"type":"string","format":"uri-reference","description":"The unique reference to this item in the impact.com API."}}}}}}
```

## Delete a General Exception List Item

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

```json
{"openapi":"3.1.0","info":{"title":"Brand API - General Exception Lists","version":"v14"},"servers":[{"url":"https://api.impact.com"}],"paths":{"/Advertisers/{AccountSID}/GeneralExceptionLists/{ListId}/Items/{ItemId}":{"delete":{"summary":"Delete a General Exception List Item","description":"Permanently deletes a single item from a general exception list. This cannot be undone.","operationId":"deleteGeneralExceptionListItem","tags":["General Exception List Items"],"parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"}},{"name":"ListId","in":"path","required":true,"schema":{"type":"integer"}},{"name":"ItemId","in":"path","required":true,"description":"The unique identifier for the general 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 dynamically by asking a question.

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

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.