Get planning brief

GET /api/v2/buyer/planning-briefs/{briefId} Returns a single planning brief and its per-publisher target rows. The caller must own the brief — foreign briefs return NOT_FOUND.

Request

curl

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

Parameters

Field	In	Type	Required	Notes
`briefId`	path	integer	Yes	Brief ID to fetch

Response

Returns the brief plus its target rows (DemandSignalWithTargets).

{
  "id": "7391052846",
  "customerId": 100,
  "advertiserId": 12345,
  "buyerName": "Acme Media",
  "advertiserName": "Acme",
  "audience": "Tech-savvy professionals 25-54",
  "geo": "US, CA",
  "channels": ["ctv", "video"],
  "startDate": "2026-07-01",
  "endDate": "2026-09-30",
  "statedBudget": 250000,
  "currency": "USD",
  "status": "QUOTED",
  "targetingMode": "FILTERED",
  "qualifiedBudget": 180000,
  "recommendedProducts": [],
  "createdAt": "2026-06-01T10:00:00Z",
  "updatedAt": "2026-06-03T14:22:00Z",
  "targets": [
    {
      "id": "7391052901",
      "demandSignalId": "7391052846",
      "storefrontId": "42",
      "externalPublisherName": null,
      "externalPublisherDomain": null,
      "bucket": "LIVE",
      "dispatchStatus": "ACKNOWLEDGED",
      "matchPct": 88,
      "dispatchedAt": "2026-06-01T10:05:00Z",
      "acknowledgedAt": "2026-06-01T11:30:00Z",
      "createdAt": "2026-06-01T10:00:00Z",
      "updatedAt": "2026-06-01T11:30:00Z"
    }
  ]
}

Field	Type	Notes
`id`	string	Brief ID
`status`	enum	`SEARCHING`, `QUOTED`, `BOOKED`, `ABANDONED`, `DECLINED`
`targets`	array	Per-publisher target rows with dispatch state and timestamps
`targets[].dispatchStatus`	enum	`QUEUED`, `DISPATCHED`, `ACKNOWLEDGED`, `ON_HOLD`, `FAILED`, `DECLINED`

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

List brief responses

Seller replies

List planning briefs

Briefs you’ve shared

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

List brief responses

List planning briefs

​Request

​Parameters

​Response

​Errors

​Related

Planning brief tasks

List brief responses

List planning briefs

Request

Parameters

Response

Errors

Related