Skip to main content
GET /api/v2/buyer/campaigns/:id/media-buy-status Polls the campaign’s sales agents directly for live ADCP status and persists any changes. Useful right after execute while waiting on publisher approvals.
Webhooks from sales agents are the preferred, near-real-time path. Polling this endpoint is the fallback when you can’t receive webhooks.

​
Request

curl https://api.interchange.io/api/v2/buyer/campaigns/cmp_987654321/media-buy-status \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
No request body.

​
Parameters

FieldTypeRequiredNotes
idstringYesCampaign ID (path parameter).

​
Response

{
  "campaign_id": "cmp_987654321",
  "media_buys": [
    {
      "media_buy_id": "mb_abc123",
      "adcp_media_buy_id": "adcp_mb_001",
      "internal_status": "ACTIVE",
      "adcp_status": "active",
      "previous_internal_status": "PENDING_APPROVAL",
      "previous_adcp_status": "pending",
      "updated": true
    }
  ],
  "agents_queried": 1,
  "errors": []
}
Returns a polling result for all non-terminal media buys in the campaign. Each element in media_buys reflects one media buy queried from a sales agent:
  • internal_status — the Interchange status after this poll (one of DRAFT, PENDING_APPROVAL, INPUT_REQUIRED, ACTIVE, PAUSED, COMPLETED, CANCELED, FAILED, REJECTED, ARCHIVED).
  • adcp_status — the raw status string returned by the sales agent.
  • previous_internal_status / previous_adcp_status — values before this poll.
  • updated — true when the status changed as a result of this poll.
  • agents_queried — number of distinct sales agents queried.
  • errors — per-media-buy errors from agents that failed to respond; media_buy_id and error message are included for each failure. A partial error does not prevent successful entries from being returned.
Only non-terminal media buys (PENDING_APPROVAL, ACTIVE, PAUSED) are polled; terminal buys are excluded.

​
Errors

CodeWhen
NOT_FOUNDCampaign ID does not exist for the authenticated customer.
See Errors for the full error shape and recovery semantics.

Media buys

Media buy structure and the status enum

Execute campaign

Launch the campaign into media buys

Pause campaign

Halt spend across all media buys

Campaign overview

The campaign object and lifecycle