List brief responses

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

Field	In	Type	Required	Notes
`briefId`	path	integer	Yes	Brief 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
}

Field	Type	Notes
`items`	array	Seller responses, oldest first
`items[].id`	string	Response ID
`items[].demandSignalTargetId`	string	Target the response answers
`items[].sellerCustomerId`	integer	Responding seller account
`items[].storefrontId`	string \| null	Responding storefront, when applicable
`items[].kind`	enum	`QUOTE`, `CLARIFY`, `DECLINE`, or `BOOK`
`items[].payload`	object \| null	Response detail (e.g. quoted CPM, clarifying question)
`items[].matchScore`	integer \| null	Seller match score, 0–100
`items[].proposalCode`	string \| null	Storefront proposal code minted with a `QUOTE` (e.g. `PRP-XK4A29`); redeem via discovery. `null` on declines
`items[].createdAt`	string	When the response was recorded
`total`	integer	Total 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

Get planning brief List planning briefs

⌘I

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Request

Parameters

Response

Errors

Planning brief tasks

Get planning brief

Share a planning brief

​Request

​Parameters

​Response

​Errors

​Related

Planning brief tasks

Get planning brief

Share a planning brief

Request

Parameters

Response

Errors

Related