Skip to main content
GET
/
storefronts
/
{storefrontId}
/
demand-signals
/
{signalId}
Get a demand signal routed to a storefront
curl --request GET \
  --url https://api.interchange.io/api/v2/storefront/storefronts/{storefrontId}/demand-signals/{signalId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "customerId": 0,
  "advertiserId": 0,
  "buyerName": "<string>",
  "advertiserName": "<string>",
  "campaignName": "<string>",
  "audience": "<string>",
  "geo": "<string>",
  "channels": [],
  "exclusions": [
    {
      "values": [],
      "raw": "<string>"
    }
  ],
  "startDate": "<string>",
  "endDate": "<string>",
  "flexibility": {
    "days": 4503599627370495
  },
  "statedBudget": 123,
  "currency": "<string>",
  "primaryKpi": {
    "raw": "<string>",
    "parsed": {
      "value": 123
    }
  },
  "priceExpect": 123,
  "creativeReady": true,
  "rawPrompt": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "storefrontId": "<string>",
  "target": {
    "id": "<string>",
    "demandSignalId": "<string>",
    "storefrontId": "<string>",
    "externalPublisherName": "<string>",
    "externalPublisherDomain": "<string>",
    "matchPct": 50,
    "dispatchAttemptedAt": "<string>",
    "dispatchedAt": "<string>",
    "acknowledgedAt": "<string>",
    "errorMessage": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

API key or access token

Path Parameters

​
storefrontId
integer
required
Required range: x <= 9007199254740991
​
signalId
integer
required
Required range: x <= 9007199254740991

Response

Get a demand signal routed to a storefront

A demand signal as seen by ONE storefront. Carries only buyer-set brief fields + per-storefront state (status, target, storefrontId). Buyer-side signal-wide aggregates are intentionally excluded — they have no per-storefront variant and would leak competitive activity across sellers.

​
id
string
required
​
customerId
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
​
advertiserId
integer | null
required
Required range: -9007199254740991 <= x <= 9007199254740991
​
buyerName
string
required
​
advertiserName
string
required
​
campaignName
string | null
required
​
audience
string
required
​
geo
string
required
​
channels
enum<string>[]
required

Channel the buyer wants to reach. Maps to ADCP MediaType. Lower-case to match the AdCP wire format; only Postgres-enum types use UPPERCASE.

Available options:
display,
native,
video,
audio,
ctv,
dooh,
newsletter,
podcast
​
exclusions
object[]
required
​
startDate
string
required
​
endDate
string
required
​
flexibility
object
required
​
statedBudget
number
required
​
currency
string
required
​
primaryKpi
object
required
​
priceExpect
number | null
required
​
creativeReady
boolean | null
required
​
rawPrompt
string | null
required
​
targetingMode
enum<string>
required

DIRECT = buyer named the seller(s). FILTERED = matched ≤5 candidates. BROAD = >5.

Available options:
DIRECT,
FILTERED,
BROAD
​
createdAt
string
required
​
updatedAt
string
required
​
status
enum<string>
required

Lifecycle of a demand signal. SEARCHING on create; QUOTED when at least one seller responds; BOOKED when at least one target converts to a deal; ABANDONED after idle; DECLINED if every target declined.

Available options:
SEARCHING,
QUOTED,
BOOKED,
ABANDONED,
DECLINED
​
storefrontId
string
required
​
target
object
required

One target publisher within a demand signal. Identified by either storefrontId (live / coming-soon) or externalPublisherName (not-on-Interchange) — never both.