Get update proposal

GET /api/v2/buyer/update-proposals/{id} Returns the current resolution status of a media buy update proposal — PENDING, APPROVED, or REJECTED — along with rejectionReason and resolvedAt when available. Poll this until status leaves PENDING.

Request

curl "https://api.interchange.io/api/v2/buyer/update-proposals/upd_7c12a3" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Param	Type	Required	Notes
`id`	string (path)	Yes	Update proposal ID

Response

{
  "id": "upd_7c12a3",
  "status": "REJECTED",
  "mediaBuyId": "mb_abc",
  "rejectionReason": "Requested budget exceeds the agent's per-flight cap",
  "resolvedAt": "2026-06-06T18:30:00Z"
}

rejectionReason is present only when status is REJECTED. resolvedAt is present once the proposal leaves PENDING.

Errors

404 NOT_FOUND — the proposal does not exist or belongs to a different account.

See Errors for the full error contract.

Update proposal tasks

All update proposal operations

Cancel update proposal

Withdraw a pending proposal

Cancel update proposal Moderation

⌘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

Update proposal tasks

Cancel update proposal

​Request

​Parameters

​Response

​Errors

​Related

Update proposal tasks

Cancel update proposal

Request

Parameters

Response

Errors

Related