List planning briefs

GET /api/v2/buyer/planning-briefs Lists the planning briefs the calling account has shared with publishers. Returns the buyer-facing view — the internal matchScore aggregate is never exposed. Filterable by status and advertiser, offset-paginated.

Request

curl

curl "https://api.interchange.io/api/v2/buyer/planning-briefs?status=QUOTED&limit=20" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	In	Type	Required	Notes
`status`	query	enum	No	`SEARCHING`, `QUOTED`, `BOOKED`, `ABANDONED`, or `DECLINED`
`advertiserId`	query	integer	No	Filter to briefs for one advertiser
`limit`	query	integer	No	Max results (1–100)
`offset`	query	integer	No	Pagination offset (default 0)

Response

{
  "items": [
    {
      "id": "7391052846",
      "customerId": 100,
      "advertiserId": 12345,
      "buyerName": "Acme Media",
      "advertiserName": "Acme",
      "campaignName": "Q3 CTV Push",
      "audience": "Tech-savvy professionals 25-54",
      "geo": "US, CA",
      "channels": ["ctv", "video"],
      "exclusions": [],
      "startDate": "2026-07-01",
      "endDate": "2026-09-30",
      "flexibility": { "mode": "flexible", "days": 7 },
      "statedBudget": 250000,
      "currency": "USD",
      "primaryKpi": null,
      "priceExpect": null,
      "creativeReady": true,
      "rawPrompt": null,
      "status": "QUOTED",
      "targetingMode": "FILTERED",
      "qualifiedBudget": 180000,
      "recommendedProducts": [],
      "targetCount": 3,
      "responseSummary": { "quotes": 2, "clarifies": 1, "declines": 0, "books": 0 },
      "createdAt": "2026-06-01T10:00:00Z",
      "updatedAt": "2026-06-03T14:22:00Z"
    }
  ],
  "total": 1,
  "hasMore": false,
  "nextOffset": null
}

Field	Type	Notes
`items`	array	Buyer-facing brief views (no `matchScore`)
`items[].id`	string	Brief ID
`items[].status`	enum	`SEARCHING`, `QUOTED`, `BOOKED`, `ABANDONED`, `DECLINED`
`items[].targetingMode`	enum	`DIRECT`, `FILTERED`, `BROAD`
`items[].targetCount`	integer	Number of publisher targets on the brief
`items[].responseSummary`	object	`{ quotes, clarifies, declines, books }` counts
`total`	integer	Total briefs matching the query
`hasMore`	boolean	Whether more pages exist
`nextOffset`	integer \| null	Offset for the next page, or `null`

Errors

400 VALIDATION_ERROR — invalid status enum or out-of-range limit.
401 UNAUTHORIZED — missing or invalid bearer token.

See Errors for the full error contract.

Planning brief tasks

All planning brief operations

Share a planning brief

Create and dispatch

Get planning brief

Brief with target rows

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

Share a planning brief

Get planning brief

​Request

​Parameters

​Response

​Errors

​Related

Planning brief tasks

Share a planning brief

Get planning brief

Request

Parameters

Response

Errors

Related