Skip to main content
GET
/
storefronts
/
{storefrontId}
/
demand-signals
List demand signals routed to a storefront
curl --request GET \
  --url https://api.interchange.io/api/v2/storefront/storefronts/{storefrontId}/demand-signals \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "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>",
      "qualifiedBudget": 123,
      "recommendedProducts": [
        {
          "productId": "<string>",
          "name": "<string>",
          "estimatedCpm": 123,
          "estimatedImpressions": 4503599627370495,
          "estimatedReach": 4503599627370495,
          "matchPct": 50,
          "rationale": "<string>"
        }
      ],
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "matchScore": 50,
      "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>"
      },
      "storefrontId": "<string>"
    }
  ],
  "total": 4503599627370495,
  "hasMore": true,
  "nextOffset": 4503599627370495
}

Documentation Index

Fetch the complete documentation index at: https://docs.interchange.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key or access token

Path Parameters

​
storefrontId
integer
required
Required range: x <= 9007199254740991

Query Parameters

​
status
enum<string>

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
​
dispatchStatus
enum<string>

Per-target dispatch state. ACKNOWLEDGED means the seller agent confirmed receipt; status transitions to DECLINED if the agent rejects the brief.

Available options:
QUEUED,
DISPATCHED,
ACKNOWLEDGED,
ON_HOLD,
FAILED,
DECLINED
​
channel
enum<string>

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
​
minMatchPct
integer
Required range: 0 <= x <= 100
​
limit
integer
Required range: x <= 100
​
offset
integer
Required range: 0 <= x <= 9007199254740991

Response

List demand signals routed to a storefront

Paginated list of demand signals routed to a storefront.

​
items
object[]
required
​
total
integer
required
Required range: 0 <= x <= 9007199254740991
​
hasMore
boolean
required
​
nextOffset
integer | null
required
Required range: 0 <= x <= 9007199254740991