Exception Lists
Returns a list of your exception lists, which can be filtered by campaign, state, or type.
Use your AccountSID as the username and AuthToken as the password.
Filter by the program ID the list applies to.
Filter lists by their current state.
Filter lists by whether they apply to CATEGORY or SKU.
A paginated list of exception list objects.
curl -L \
--url 'https://api.impact.com/Advertisers/{AccountSID}/ExceptionLists' \
--user '{AccountSID}:{AuthToken}' \
--header 'Accept: */*'A paginated list of exception list objects.
{
"ExceptionLists": [
{
"Id": 99999,
"Name": "USA-State-CA-Exclusions",
"State": "ACTIVE",
"CampaignId": 1000,
"Type": "CATEGORY",
"CreatedDate": "2026-01-15T10:00:00-08:00",
"DeactivationDate": "2026-12-31T23:59:59-08:00",
"ActionTrackers": [
{
"Id": 18500,
"Name": "Online Sale"
}
],
"NumberOfItems": 50,
"ItemsUri": "/Advertisers/<AccountSID>/ExceptionLists/99999/Items",
"Uri": "/Advertisers/<AccountSID>/ExceptionLists/12345"
}
]
}Creates a new, empty exception list for a specific campaign and type.
Use your AccountSID as the username and AuthToken as the password.
Comma-separated list of event type IDs.
18500The program ID the list applies to.
1000The display name for the exception list.
USA-State-CA-ExclusionsWhether this list applies to CATEGORY or SKU.
The request was successful.
Indicates whether the operation was successful.
OKThe unique reference to the affected resource.
curl -L \
--request POST \
--url 'https://api.impact.com/Advertisers/{AccountSID}/ExceptionLists' \
--user '{AccountSID}:{AuthToken}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Accept: */*'The request was successful.
{
"Status": "OK",
"Uri": "../folder"
}Retrieves the details of an existing exception list by its unique ID.
Use your AccountSID as the username and AuthToken as the password.
The unique identifier for the exception list.
A single exception list object.
The unique identifier for the exception list.
99999The display name for the exception list.
USA-State-CA-ExclusionsThe current state of the exception list.
The program ID the list applies to.
1000Whether the list applies to CATEGORY or SKU.
The date and time the list was created.
2026-01-15T10:00:00-08:00The date and time the list was deactivated, if applicable.
2026-12-31T23:59:59-08:00The total number of items in the list.
50The unique reference to the items collection for this list.
/Advertisers/<AccountSID>/ExceptionLists/99999/ItemsThe unique reference to this exception list in the impact.com API.
/Advertisers/<AccountSID>/ExceptionLists/12345curl -L \
--url 'https://api.impact.com/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}' \
--user '{AccountSID}:{AuthToken}' \
--header 'Accept: */*'A single exception list object.
{
"Id": 99999,
"Name": "USA-State-CA-Exclusions",
"State": "ACTIVE",
"CampaignId": 1000,
"Type": "CATEGORY",
"CreatedDate": "2026-01-15T10:00:00-08:00",
"DeactivationDate": "2026-12-31T23:59:59-08:00",
"ActionTrackers": [
{
"Id": 18500,
"Name": "Online Sale"
}
],
"NumberOfItems": 50,
"ItemsUri": "/Advertisers/<AccountSID>/ExceptionLists/99999/Items",
"Uri": "/Advertisers/<AccountSID>/ExceptionLists/12345"
}Updates the specified exception list's name, type, or associated action trackers.
Use your AccountSID as the username and AuthToken as the password.
The unique identifier for the exception list to update.
Comma-separated list of event type IDs.
18500The display name for the exception list.
USA-State-CA-ExclusionsWhether this list applies to CATEGORY or SKU.
The request was successful.
Indicates whether the operation was successful.
OKThe unique reference to the affected resource.
curl -L \
--request PUT \
--url 'https://api.impact.com/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}' \
--user '{AccountSID}:{AuthToken}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Accept: */*'The request was successful.
{
"Status": "OK",
"Uri": "../folder"
}Last updated

