General Exception List Items
Returns a list of all items within a specific general exception list.
The unique identifier for the general exception list.
Filter items by their 'Value'.
A list of general exception list item objects.
curl -L \
--url 'https://api.impact.com/Advertisers/{AccountSID}/GeneralExceptionLists/{ListId}/Items' \
--user '{AccountSID}:{AuthToken}' \
--header 'Accept: */*'A list of general exception list item objects.
{
"GeneralExceptionListItems": [
{
"Id": 644814,
"Value": "AUD",
"Name": "AUD",
"MatchMode": "EQ",
"ListId": 23,
"CreatedDate": "2026-07-23T12:44:43-07:00",
"Uri": "/Advertisers/<AccountSID>/GeneralExceptionLists/23/Items/644814"
}
]
}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.
The unique identifier for the general exception list.
The attribute value to match against incoming actions.
AUDDisplay name for the item.
AUDIf true, updates an existing item with the same 'Value' instead of creating a duplicate.
falseExample: trueThe request was successful.
Indicates whether the operation was successful.
OKThe unique reference to the affected resource.
/Advertisers/<AccountSID>/GeneralExceptionLists/23curl -L \
--request POST \
--url 'https://api.impact.com/Advertisers/{AccountSID}/GeneralExceptionLists/{ListId}/Items' \
--user '{AccountSID}:{AuthToken}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Accept: */*'The request was successful.
{
"Status": "OK",
"Uri": "/Advertisers/<AccountSID>/GeneralExceptionLists/23"
}Permanently deletes all items in a general exception list. This cannot be undone.
The unique identifier for the general exception list.
All items were deleted successfully.
Indicates that the resource was deleted.
DELETEDcurl -L \
--request DELETE \
--url 'https://api.impact.com/Advertisers/{AccountSID}/GeneralExceptionLists/{ListId}/Items' \
--user '{AccountSID}:{AuthToken}' \
--header 'Accept: */*'All items were deleted successfully.
{
"Status": "DELETED"
}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.
The unique identifier for the general exception list.
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.
The request was successful.
Indicates whether the operation was successful.
OKThe unique reference to the affected resource.
/Advertisers/<AccountSID>/GeneralExceptionLists/23curl -L \
--request PATCH \
--url 'https://api.impact.com/Advertisers/{AccountSID}/GeneralExceptionLists/{ListId}/Items' \
--user '{AccountSID}:{AuthToken}' \
--header 'Accept: */*' \
--form 'File=@/path/to/items.csv'The request was successful.
{
"Status": "OK",
"Uri": "/Advertisers/<AccountSID>/GeneralExceptionLists/23"
}Retrieves the details of a single item from a general exception list.
The unique identifier for the general exception list item.
A single general exception list item object.
The unique identifier for the general exception list item.
644814The attribute value to match against incoming actions (e.g. a city name, currency code, or custom identifier).
AUDDisplay name for the item. Returned as an empty string when not set.
AUDHow 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.
EQPossible values: The unique identifier of the parent general exception list.
23The 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.
2026-07-23T12:44:43-07:00The unique reference to this item in the impact.com API.
/Advertisers/<AccountSID>/GeneralExceptionLists/23/Items/644814curl -L \
--url 'https://api.impact.com/Advertisers/{AccountSID}/GeneralExceptionLists/{ListId}/Items/{ItemId}' \
--user '{AccountSID}:{AuthToken}' \
--header 'Accept: */*'A single general exception list item object.
{
"Id": 644814,
"Value": "AUD",
"Name": "AUD",
"MatchMode": "EQ",
"ListId": 23,
"CreatedDate": "2026-07-23T12:44:43-07:00",
"Uri": "/Advertisers/<AccountSID>/GeneralExceptionLists/23/Items/644814"
}Permanently deletes a single item from a general exception list. This cannot be undone.
The unique identifier for the general exception list item.
The item was deleted successfully.
Indicates that the resource was deleted.
DELETEDcurl -L \
--request DELETE \
--url 'https://api.impact.com/Advertisers/{AccountSID}/GeneralExceptionLists/{ListId}/Items/{ItemId}' \
--user '{AccountSID}:{AuthToken}' \
--header 'Accept: */*'The item was deleted successfully.
{
"Status": "DELETED"
}Last updated
