Skip to main content
GET /api/v2/buyer/planning-briefs/{briefId}/responses Lists every publisher response (QUOTE / CLARIFY / DECLINE / BOOK) recorded against the caller-owned planning brief. Ordered oldest first so you can replay the conversation.

​
Request

curl
curl https://api.interchange.io/api/v2/buyer/planning-briefs/7391052846/responses \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldInTypeRequiredNotes
briefIdpathintegerYesBrief ID whose responses to list

​
Response

{
  "items": [
    {
      "id": "7391053012",
      "demandSignalId": "7391052846",
      "demandSignalTargetId": "7391052901",
      "sellerCustomerId": 501,
      "storefrontId": "42",
      "kind": "QUOTE",
      "payload": { "proposedCpm": 22.5, "currency": "USD", "products": [] },
      "matchScore": 88,
      "actorUserId": null,
      "proposalCode": "PRP-XK4A29",
      "createdAt": "2026-06-03T14:22:00Z"
    }
  ],
  "total": 1
}
FieldTypeNotes
itemsarraySeller responses, oldest first
items[].idstringResponse ID
items[].demandSignalTargetIdstringTarget the response answers
items[].sellerCustomerIdintegerResponding seller customer
items[].storefrontIdstring | nullResponding storefront, when applicable
items[].kindenumQUOTE, CLARIFY, DECLINE, or BOOK
items[].payloadobject | nullResponse detail (e.g. quoted CPM, clarifying question)
items[].matchScoreinteger | nullSeller match score, 0–100
items[].proposalCodestring | nullStorefront proposal code minted with a QUOTE (e.g. PRP-XK4A29); redeem via discovery. null on declines
items[].createdAtstringWhen the response was recorded
totalintegerTotal responses on the brief

​
Errors

  • 401 UNAUTHORIZED — missing or invalid bearer token.
  • 404 NOT_FOUND — the brief does not exist or is not owned by the caller.
See Errors for the full error contract.

Planning brief tasks

All planning brief operations

Get planning brief

Brief with target rows

Share a planning brief

Create and dispatch