Skip to main content
These endpoints give your storefront its observability surface: an activity feed of who changed what, reporting metrics for every media buy that flows through your inventory sources, and a non-blocking moderation pre-check so agents can validate text before submitting it to a blocking surface. All examples use the storefront base URL: 
https://api.interchange.io/api/v2/storefront
Authenticate every request with Authorization: Bearer $SCOPE3_API_KEY. The storefront is resolved from your API key’s customer context.

​
Key concepts

  • Reporting is participation-based. The storefront does not own the underlying media buys. Reporting is visible because the Merchandising Agent is the ADCP party to those transactions. The hierarchy is advertiser → media buy → package — there is no campaign level.
  • Two reporting views. summary returns a hierarchical advertiser/media-buy/package breakdown; timeseries returns flat per-day rows. Use inventorySourceId to scope to one source.
  • Activity is append-only. The audit feed records configuration and inventory-source changes. Each row attributes the actor (user or service token) and carries the before/after changes.
  • Moderation pre-check never blocks. It returns structured findings so an agent can self-correct. wouldBlock tells you whether the same content would trigger a 422 on a real blocking surface.

​
Task reference

List activity

Audit feed of storefront changes

Get reporting metrics

Delivery metrics by advertiser

Check moderation

Non-blocking content pre-check

All activity tasks

Every operation in one place

Inventory sources

The sources reporting flows through

Errors

Shared error contract