Skip to main content
GET /api/v2/storefront/audit-logs Returns the storefront activity feed: recent configuration and inventory-source changes, with the actor and before/after values attributed per row. Filter by resource type, inventory source, and date range.

​
Request

curl
curl -G https://api.interchange.io/api/v2/storefront/audit-logs \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  --data-urlencode "resourceTypes=STOREFRONT_INVENTORY_SOURCE" \
  --data-urlencode "inventorySourceId=source_abc123" \
  --data-urlencode "startDate=2026-03-01T00:00:00Z" \
  --data-urlencode "take=50"

​
Parameters

FieldTypeRequiredNotes
startDatestringNoISO timestamp; include logs at or after this time
endDatestringNoISO timestamp; include logs at or before this time
inventorySourceIdstringNoFilter to a single storefront inventory source by source ID
resourceTypesenum | arrayNoSTOREFRONT or STOREFRONT_INVENTORY_SOURCE. Defaults to all storefront resource types
takeintegerNoResults to return, max 500 (default 50)
skipintegerNoResults to skip for pagination (default 0)

​
Response

{
  "logs": [
    {
      "id": 90217,
      "timestamp": "2026-03-04T18:22:11Z",
      "createdAt": "2026-03-04T18:22:11Z",
      "action": "UPDATE",
      "resourceType": "STOREFRONT_INVENTORY_SOURCE",
      "resourceId": "source_abc123",
      "resourceName": "Northwind CTV",
      "userId": 4412,
      "userEmail": "ops@northwind.example",
      "userName": "Northwind Ops",
      "serviceTokenId": null,
      "serviceTokenName": null,
      "parameters": { "status": "ACTIVE" },
      "changes": { "status": { "from": "PENDING", "to": "ACTIVE" } },
      "description": "Activated inventory source Northwind CTV"
    }
  ],
  "total": 1
}
FieldTypeNotes
logs[]arrayAudit rows, newest first
logs[].actionstringThe change applied (e.g. CREATE, UPDATE, DELETE)
logs[].resourceTypestringSTOREFRONT or STOREFRONT_INVENTORY_SOURCE
logs[].resourceId / resourceNamestring | nullThe affected resource
logs[].userId / userEmail / userNamemixed | nullActor when a user made the change
logs[].serviceTokenId / serviceTokenNamemixed | nullActor when a service token made the change
logs[].parametersobject | nullRequest parameters captured for the action
logs[].changesobject | nullBefore/after values
logs[].descriptionstringHuman-readable summary
totalintegerTotal matching rows (for pagination)

​
Errors

  • 400 VALIDATION_ERROR — malformed date or take over 500.
  • 401 UNAUTHORIZED — missing or invalid API key.
See Errors for the full error contract.

Activity tasks

All activity operations

Inventory sources

The sources these logs track

Get reporting metrics

Delivery metrics