HomeGuidesAPI ReferenceAPI Changelog
Log In
API Reference
Start typing to search…

List all items for an exception list

Returns a list of one exception list's items.

Parameters

Value optional

What the exception list item is searching for. This will be the CATEGORY or SKU value that the exception list looks at, depending on the exception list's Type.

Returns

Returns an array of (exception list) item objects up to a limit dictated by @pagesize. Each entry in the array is a separate (exception list) item object. If no (exception list) item objects meet the criteria, the resulting array will be empty. This request should never return an error.

Example Request

curl 'https://api.impact.com/Advertisers/<AccountSID>/ExceptionLists/<ExceptionListId>/Items' \
  -X GET \
  -u '<AccountSID>:<AuthToken>' \
  -H 'Accept: application/json' \
  -d 'Value=Anvils' \
  -G

Example Response

{
  "@page": "1",
  ...
  "ExceptionListItems": [
    {
      "Id": "80000000",
      "Value": "Anvils",
      "Name": "White Anvil",
      "MatchMode": "EQ",
      "ListId": "00042",
      "CreatedDate": "2019-09-03T16:15:23-07:00",
      "Uri": "/Advertisers/<AccountSID>/ExceptionLists/1000/Items/80000000"
      },
    ...
  ]
}