Impact

Impact Exception List Items API

The Exception List Items API from Impact — 2 operation(s) for exception list items.

Documentation GitHub OpenAPI

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items List items in an exception list · List Items in an Exception List #

Ask an LLM

“Which values are on one of my exception lists?”

“Can I check whether a specific value is already in an exception list?”

Tell an agent

List the items in exception list {list} for account {account}.

Find value {value} in exception list {list}, account {account}.

POST /Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items Add items to an exception list · Create Items in an Exception List #

Ask an LLM

“Can I add one value, or upload a file of many, to an exception list?”

“Is there an upsert option when adding exception list items?”

Tell an agent

Add value {value} named {name} to exception list {list} in account {account}.

Upload file {file} of new items to exception list {list}, account {account}.

PATCH /Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items Replace all items in an exception list from a file · Replace All Items in an Exception List #

Ask an LLM

“Can I swap an exception list's entire contents with a new CSV or XLSX file?”

“Which file formats are accepted when replacing an exception list's items?”

Tell an agent

Replace everything in exception list {list} with file {file} in account {account}.

Overwrite exception list {list} in account {account} using spreadsheet {file}.

DELETE /Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items Delete all items from an exception list · Delete All Items from an Exception List #

Ask an LLM

“Can I empty an exception list in one call?”

“Is clearing every item from an exception list undoable?”

Tell an agent destructive · confirm first

Clear every item out of exception list {list} in account {account}.

Empty exception list {list} for account {account}.

GET /Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items/{ItemId} Get one exception list item · Get Exception List Item Details #

Ask an LLM

“What are the details of a single entry in an exception list?”

“Can I fetch one exception list item by its ID?”

Tell an agent

Get item {item} from exception list {list} in account {account}.

Show exception list entry {item} on list {list}, account {account}.

DELETE /Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items/{ItemId} Delete one item from an exception list · Delete an Exception List Item #

Ask an LLM

“Can I remove just one value from an exception list without touching the rest?”

“Is removing a single exception list entry permanent?”

Tell an agent destructive · confirm first

Delete item {item} from exception list {list} in account {account}.

Remove only entry {item} from exception list {list}, account {account}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/impact:impact-exception-list-items-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Brand API - Exception Lists Exception List Items API
  description: API for managing Exception Lists, which are used to pay partners different rates based on the category or SKU of products in a conversion. This includes managing the lists and their individual items.
  version: v14
servers:
- url: https://api.impact.com
security:
- basicAuth: []
tags:
- name: Exception List Items
paths:
  /Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items:
    get:
      summary: List Items in an Exception List
      description: Returns a list of all items within a specific exception list.
      operationId: listExceptionListItems
      tags:
      - Exception List Items
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
      - name: ExceptionListId
        in: path
        required: true
        description: The unique identifier for the exception list.
        schema:
          type: integer
      - name: Value
        in: query
        description: Filter items by their 'Value' (the specific SKU or Category).
        schema:
          type: string
      responses:
        '200':
          description: A paginated list of exception list item objects.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ExceptionListItems:
                    type: array
                    description: The list of items in this exception list.
                    items:
                      $ref: '#/components/schemas/ExceptionListItem'
      x-codeSamples:
      - lang: cURL
        source: "curl -L \\\n  --url 'https://api.impact.com/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items' \\\n  --user '{AccountSID}:{AuthToken}' \\\n  --header 'Accept: */*'"
    post:
      summary: Create Items in an Exception List
      description: Creates one or more new items for an exception list, either via form parameters for a single item or by uploading a file for multiple items.
      operationId: createExceptionListItems
      tags:
      - Exception List Items
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
      - name: ExceptionListId
        in: path
        required: true
        description: The unique identifier for the exception list.
        schema:
          type: integer
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/ExceptionListItemCreateForm'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/ExceptionListItemCreateFile'
        description: 'To create a single item, send `Value` (and optionally `Name`) as `application/x-www-form-urlencoded`.


          To bulk-upload items from a `.csv` or `.xlsx` file, switch the content type to `multipart/form-data` and send the `File` parameter.'
      responses:
        '200':
          description: The request was successful.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessUriResponse'
      x-codeSamples:
      - lang: cURL
        source: "curl -L \\\n  --request POST \\\n  --url 'https://api.impact.com/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items' \\\n  --user '{AccountSID}:{AuthToken}' \\\n  --header 'Content-Type: application/x-www-form-urlencoded' \\\n  --header 'Accept: */*'"
    patch:
      summary: Replace All Items in an Exception List
      description: Replaces all items within an existing exception list by uploading a new .CSV or .XLSX file.
      operationId: replaceExceptionListItems
      tags:
      - Exception List Items
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
      - name: ExceptionListId
        in: path
        required: true
        description: The unique identifier for the 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.
      responses:
        '200':
          description: The request was successful.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessUriResponse'
      x-codeSamples:
      - lang: cURL
        source: "curl -L \\\n  --request PATCH \\\n  --url 'https://api.impact.com/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items' \\\n  --user '{AccountSID}:{AuthToken}' \\\n  --header 'Accept: */*'"
    delete:
      summary: Delete All Items from an Exception List
      description: Permanently deletes all items in an exception list. This cannot be undone.
      operationId: deleteAllExceptionListItems
      tags:
      - Exception List Items
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
      - name: ExceptionListId
        in: path
        required: true
        description: The unique identifier for the 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.
                    example: DELETED
      x-codeSamples:
      - lang: cURL
        source: "curl -L \\\n  --request DELETE \\\n  --url 'https://api.impact.com/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items' \\\n  --user '{AccountSID}:{AuthToken}' \\\n  --header 'Accept: */*'"
  /Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items/{ItemId}:
    get:
      summary: Get Exception List Item Details
      description: Retrieves the details of a single item from an exception list.
      operationId: getExceptionListItemById
      tags:
      - Exception List Items
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
      - name: ExceptionListId
        in: path
        required: true
        schema:
          type: integer
      - name: ItemId
        in: path
        required: true
        description: The unique identifier for the exception list item.
        schema:
          type: integer
      responses:
        '200':
          description: A single exception list item object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionListItem'
      x-codeSamples:
      - lang: cURL
        source: "curl -L \\\n  --url 'https://api.impact.com/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items/{ItemId}' \\\n  --user '{AccountSID}:{AuthToken}' \\\n  --header 'Accept: */*'"
    delete:
      summary: Delete an Exception List Item
      description: Permanently deletes a single item from an exception list. This cannot be undone.
      operationId: deleteExceptionListItem
      tags:
      - Exception List Items
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
      - name: ExceptionListId
        in: path
        required: true
        schema:
          type: integer
      - name: ItemId
        in: path
        required: true
        description: The unique identifier for the 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.
                    example: DELETED
      x-codeSamples:
      - lang: cURL
        source: "curl -L \\\n  --request DELETE \\\n  --url 'https://api.impact.com/Advertisers/{AccountSID}/ExceptionLists/{ExceptionListId}/Items/{ItemId}' \\\n  --user '{AccountSID}:{AuthToken}' \\\n  --header 'Accept: */*'"
components:
  schemas:
    ExceptionListItem:
      type: object
      properties:
        Id:
          type: integer
          description: The unique identifier for the exception list item.
          example: 1001
        Value:
          type: string
          description: The CATEGORY or SKU value.
          example: CA
        Name:
          type: string
          description: Display name for the item.
          example: California
        MatchMode:
          type: string
          description: How the value is matched against incoming actions.
          enum:
          - EQ
          - REGEX
        ListId:
          type: integer
          description: The unique identifier of the parent exception list.
          example: 99999
        CreatedDate:
          type: string
          format: date-time
          description: The date and time the item was created.
          example: '2026-01-15T10:00:00-08:00'
        Uri:
          type: string
          format: uri-reference
          description: The unique reference to this item in the impact.com API.
          example: /Advertisers/<AccountSID>/ExceptionLists/99999/Items/1001
    ExceptionListItemCreateFile:
      type: object
      required:
      - File
      properties:
        File:
          type: string
          format: binary
          description: A .CSV or .XLSX file containing the items to be added.
        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.
          example: OK
        Uri:
          type: string
          format: uri-reference
          description: The unique reference to the affected resource.
    ExceptionListItemCreateForm:
      type: object
      required:
      - Value
      properties:
        Value:
          type: string
          description: The CATEGORY or SKU value.
          example: CA
        Name:
          type: string
          description: Display name for contracting purposes.
          example: California
        Upsert:
          type: boolean
          default: false
          description: If true, updates an existing item with the same 'Value'.
          example: true
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Use your AccountSID as the username and AuthToken as the password.
x-default-client: cURL

Impact Exception List Items API

Operations 6

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification