Exception Lists

List all exception lists

get

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

AccountSIDstringRequired

The unique identifier for the account.

Query parameters

CampaignIdintegerOptional

Filter by the program ID the list applies to.

Statestring · enumOptional

Filter lists by their current state.

Possible values:

Typestring · enumOptional

Filter lists by whether they apply to CATEGORY or SKU.

Possible values:

Responses

200

A list of exception list objects.

application/json

get/Advertisers/{AccountSID}/ExceptionLists

cURL

curl -L \
  --url 'https://api.impact.com/Advertisers/{AccountSID}/ExceptionLists' \
  --user '{AccountSID}:{AuthToken}' \
  --header 'Accept: */*'

200

A 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"
    }
  ]
}

Create an exception list

post

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

AccountSIDstringRequired

The unique identifier for the account.

Body

application/x-www-form-urlencoded

ActionTrackerIdstringRequired

Comma-separated list of event type IDs.

Example: 18500

CampaignIdintegerRequired

The program ID the list applies to.

Example: 1000

NamestringRequired

The display name for the exception list.

Example: USA-State-CA-Exclusions

Typestring · enumRequired

Whether this list applies to CATEGORY or SKU.

Possible values:

Responses

200

The exception list was created successfully.

application/json

StatusstringOptional

Indicates whether the operation was successful.

Uristring · uri-referenceOptional

The unique reference to the affected resource.

post/Advertisers/{AccountSID}/ExceptionLists

cURL

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: */*'

200

The exception list was created successfully.

{
  "Status": "text",
  "Uri": "../folder"
}

Retrieve an exception list

get

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

AccountSIDstringRequired

The unique identifier for the account.

ExceptionListIdintegerRequired

The unique identifier for the exception list.

Responses

200

A single exception list object.

application/json

IdintegerOptional

The unique identifier for the exception list.

Example: 99999

NamestringOptional

The display name for the exception list.

Example: USA-State-CA-Exclusions

Statestring · enumOptional

The current state of the exception list.

Possible values:

CampaignIdintegerOptional

The program ID the list applies to.

Example: 1000

Typestring · enumOptional

Whether the list applies to CATEGORY or SKU.

Possible values:

CreatedDatestring · date-timeOptional

The date and time the list was created.

Example: 2026-01-15T10:00:00-08:00

DeactivationDatestring · date-time · nullableOptional

The date and time the list was deactivated, if applicable.

Example: 2026-12-31T23:59:59-08:00

NumberOfItemsintegerOptional

The total number of items in the list.

Example: 50

ItemsUristring · uri-referenceOptional

The unique reference to the items collection for this list.

Example: /Advertisers/<AccountSID>/ExceptionLists/99999/Items

Uristring · uri-referenceOptional

The unique reference to this exception list in the impact.com API.

Example: /Advertisers/<AccountSID>/ExceptionLists/12345

get/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}

cURL

curl -L \
  --url 'https://api.impact.com/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}' \
  --user '{AccountSID}:{AuthToken}' \
  --header 'Accept: */*'

200

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"
}

Update an exception list

put

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

AccountSIDstringRequired

The unique identifier for the account.

ExceptionListIdintegerRequired

The unique identifier for the exception list to update.

Body

application/x-www-form-urlencoded

ActionTrackerIdstringOptional

Comma-separated list of event type IDs.

Example: 18500

NamestringOptional

The display name for the exception list.

Example: USA-State-CA-Exclusions

Typestring · enumOptional

Whether this list applies to CATEGORY or SKU.

Possible values:

Responses

200

The exception list was updated successfully.

application/json

StatusstringOptional

Indicates whether the operation was successful.

Uristring · uri-referenceOptional

The unique reference to the affected resource.

put/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}

cURL

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: */*'

200

The exception list was updated successfully.

{
  "Status": "text",
  "Uri": "../folder"
}