List storefront activity - Interchange API

List storefront activity

curl --request GET \
  --url https://api.interchange.io/api/v2/storefront/audit-logs \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.interchange.io/api/v2/storefront/audit-logs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

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

{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

GET

/

audit-logs

List storefront activity

curl --request GET \
  --url https://api.interchange.io/api/v2/storefront/audit-logs \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.interchange.io/api/v2/storefront/audit-logs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

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

{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

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: 1 <= 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: 1 <= 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

Show child attributes

total

integer

required

Required range: 0 <= x <= 9007199254740991

⌘I