Skip to main content
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

FieldInTypeRequiredNotes
briefIdpathintegerYesBrief 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"
    }
  ]
}
FieldTypeNotes
idstringBrief ID
statusenumSEARCHING, QUOTED, BOOKED, ABANDONED, DECLINED
targetsarrayPer-publisher target rows with dispatch state and timestamps
targets[].dispatchStatusenumQUEUED, 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