Skip to main content
GET /api/v2/storefront/storefronts/{storefrontId}/demand-signals/{signalId} Returns a single demand signal routed to the caller’s storefront, with the per-target row attached. Returns 404 NOT_FOUND if the signal is not routed to this storefront.

​
Request

curl
curl https://api.interchange.io/api/v2/storefront/storefronts/4471/demand-signals/8821 \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
storefrontIdintegerYesStorefront the caller owns (path)
signalIdintegerYesDemand signal identifier (path)

​
Response

{
  "id": "ds_8f3a",
  "customerId": 33012,
  "advertiserId": 77140,
  "buyerName": "Northwind Media",
  "advertiserName": "Northwind Outdoors",
  "campaignName": "Spring Gear Launch",
  "audience": "Outdoor enthusiasts, 25-44",
  "geo": "US-CA, US-CO",
  "channels": ["ctv", "video"],
  "exclusions": [{ "type": "category", "values": ["gambling"] }],
  "startDate": "2026-07-01",
  "endDate": "2026-08-31",
  "flexibility": { "mode": "flexible", "days": 14 },
  "statedBudget": 150000,
  "currency": "USD",
  "primaryKpi": {
    "raw": "VCR above 70%",
    "parsed": { "kpi": "vcr", "op": "gte", "value": 70 }
  },
  "priceExpect": 28.0,
  "creativeReady": true,
  "rawPrompt": "Reach outdoor enthusiasts on CTV this summer",
  "targetingMode": "FILTERED",
  "createdAt": "2026-06-05T09:00:00Z",
  "updatedAt": "2026-06-05T09:00:00Z",
  "status": "SEARCHING",
  "storefrontId": "4471",
  "target": {
    "id": "tgt_22a",
    "demandSignalId": "ds_8f3a",
    "storefrontId": "4471",
    "externalPublisherName": null,
    "externalPublisherDomain": null,
    "bucket": "LIVE",
    "dispatchStatus": "ACKNOWLEDGED",
    "matchPct": 72,
    "dispatchAttemptedAt": "2026-06-05T09:01:00Z",
    "dispatchedAt": "2026-06-05T09:01:02Z",
    "acknowledgedAt": "2026-06-05T09:05:00Z",
    "errorMessage": null,
    "createdAt": "2026-06-05T09:00:30Z",
    "updatedAt": "2026-06-05T09:05:00Z"
  }
}
targetingMode tells you how you were selected: DIRECT (the buyer named you), FILTERED (matched ≤5 candidates), or BROAD (>5). The target.bucket drives dispatch: LIVE, COMING_SOON, or NOT_ON_INTERCHANGE.

​
Errors

  • 404 NOT_FOUND — the signal is not routed to this storefront.
  • 403 FORBIDDEN — the demand-supply-signals feature is not enabled, or the caller does not own the storefront.
See Errors for the full error contract.

Demand signal tasks

All demand-signal operations

List demand signals

Filterable, paginated list

Test-fit demand signal

Preview the match before responding

Respond to demand signal

QUOTE, CLARIFY, DECLINE, or BOOK