Get update proposal

Deprecated. This page documents the v2 buyer API, which is closed to new API clients and switches off on 1 December 2026. Use V3 instead: see Move a v2 buyer REST integration to V3. The conversion endpoint, Log event, stays open.

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.apostra.com/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

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Get update proposal

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