Skip to main content
GET
/
audit-logs
List storefront activity
curl --request GET \
  --url https://api.interchange.io/api/v2/storefront/audit-logs \
  --header 'Authorization: Bearer <token>'
{
  "logs": [
    {
      "id": 0,
      "timestamp": "<string>",
      "createdAt": "<string>",
      "action": "<string>",
      "resourceType": "<string>",
      "resourceId": "<string>",
      "resourceName": "<string>",
      "userId": 0,
      "userEmail": "<string>",
      "userName": "<string>",
      "serviceTokenId": 0,
      "serviceTokenName": "<string>",
      "actorOrigin": "human",
      "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"

inventorySourceId
string

Filter to a single storefront inventory source by source ID

Example:

"source_abc123"

resourceTypes

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

Available options:
STOREFRONT,
STOREFRONT_INVENTORY_SOURCE
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 storefront activity

Paginated list of storefront activity audit logs

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