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

ParamTypeRequiredNotes
idstring (path)YesUpdate 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 customer.
See Errors for the full error contract.

Update proposal tasks

All update proposal operations

Cancel update proposal

Withdraw a pending proposal