Skip to main content
A demand signal is a buyer’s brief — audience, geo, channels, budget, and KPI — routed to your storefront as a seller. You see the buyer-set fields plus the per-target row that routed the signal to you and a seller-internal matchScore. You respond with a QUOTE, CLARIFY, DECLINE, or BOOK, or run a test-fit to preview the match and a drafted reply before responding. Every demand-signal operation is scoped to a storefrontId the caller must own. Base URL https://api.interchange.io/api/v2/storefront Auth Authorization: Bearer $SCOPE3_API_KEY

​
Task reference

List demand signals

GET /storefronts/:id/demand-signals — filterable, paginated

Get demand signal

GET /storefronts/:id/demand-signals/:signalId — one signal with its target row

Respond to demand signal

POST .../respond — QUOTE, CLARIFY, DECLINE, or BOOK

Test-fit demand signal

POST .../test-fit — dry-run preview, persists nothing

Signal overview

The supply-side signal model

Errors

Error contract for every operation