Skip to main content
GET
/
audit-logs
List buyer audit logs
curl --request GET \
  --url https://api.interchange.io/api/v2/buyer/audit-logs \
  --header 'Authorization: Bearer <token>'
{
  "logs": [
    {
      "id": 0,
      "timestamp": "<string>",
      "createdAt": "<string>",
      "action": "<string>",
      "resourceType": "<string>",
      "resourceId": "<string>",
      "resourceName": "<string>",
      "parentType": "<string>",
      "advertiserId": 0,
      "userId": 0,
      "userEmail": "<string>",
      "userName": "<string>",
      "serviceTokenId": 0,
      "serviceTokenName": "<string>",
      "actorOrigin": "agent",
      "outcome": "succeeded",
      "parameters": {},
      "changes": {},
      "description": "<string>"
    }
  ],
  "total": 4503599627370495
}

Authorizations

​
Authorization
string
header
required

API key or access token

Query Parameters

​
startDate
string

ISO timestamp; only include audit logs at or after this time

Example:

"2026-03-01T00:00:00Z"

​
endDate
string

ISO timestamp; only include audit logs at or before this time

Example:

"2026-04-01T00:00:00Z"

​
advertiserId
integer

Filter to audit logs scoped to a single advertiser

Required range: x <= 9007199254740991
Example:

42

​
campaignId
string

Filter to a campaign and all of its activity (media buys, creatives, etc.)

Example:

"camp_abc123"

​
resourceTypes

Filter to a subset of buyer resource types. Defaults to all buyer resource types.

Available options:
ADVERTISER,
CAMPAIGN,
CREATIVE,
MEDIA_BUY,
PRODUCT,
PACKAGE
​
actorOrigin
enum<string>

Filter to actions initiated a particular way: "agent" surfaces only changes Murph made on a user's behalf, "human" only direct user changes.

Available options:
human,
agent,
autonomous,
system
Example:

"agent"

​
actorUserId
integer

Filter to actions taken by a specific user (by user id)

Required range: x <= 9007199254740991
Example:

10

​
actorUserEmail
string

Filter to actions taken by a specific user (by email)

Example:

"jane@acme.com"

​
resourceId
string

Filter to a single resource by its external id (e.g. an advertiser, creative, or media buy id)

Example:

"creative_abc123"

​
actions

Narrow to a subset of meaningful actions (e.g. only DELETE/ARCHIVE). Defaults to all meaningful actions.

Available options:
CREATE,
UPDATE,
DELETE,
ARCHIVE,
EXECUTE,
ACTIVATE,
DEACTIVATE
​
outcome
enum<string>

Filter by whether the action took effect. Omit to see only changes that succeeded (the default feed). Pass "denied" to see blocked attempts or "failed" for errored ones — these attempt views are not limited to the default resource types.

Available options:
succeeded,
denied,
failed
Example:

"denied"

​
take
integer
default:50

Number of results to return (max 500)

Required range: x <= 500
Example:

50

​
skip
integer
default:0

Number of results to skip for pagination

Required range: 0 <= x <= 9007199254740991
Example:

0

Response

List buyer audit logs

Paginated list of buyer activity audit logs

​
logs
object[]
required
​
total
integer
required
Required range: 0 <= x <= 9007199254740991