Skip to main content
GET /api/v2/storefront/media-buy-approvals/{mediaBuyId} Fetches one approval-queue entry by the buyer’s AdCP mediaBuyId. Returns the raw submitted payload alongside the current status, any decision you recorded, and the upstream forwarding stamp.

​
Request

curl "https://api.interchange.io/api/v2/storefront/media-buy-approvals/mb_2026_q2_ctv" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
mediaBuyIdstringYesPath param — buyer-supplied media buy identifier (AdCP media_buy_id)

​
Response

{
  "id": "42",
  "storefrontId": "1234",
  "mediaBuyId": "mb_2026_q2_ctv",
  "buyerCustomerId": 8801,
  "submittedPayload": {
    "media_buy_id": "mb_2026_q2_ctv",
    "total_budget": 50000,
    "currency": "USD"
  },
  "status": "approved",
  "reviewedBy": "5567",
  "reviewedAt": "2026-06-02T12:30:00Z",
  "reviewerNotes": "Targeting within coverage; cleared",
  "forwardedAt": "2026-06-02T12:30:05Z",
  "createdAt": "2026-06-02T10:00:00Z",
  "updatedAt": "2026-06-02T12:30:05Z"
}
Returns the matching PendingMediaBuyResponse. submittedPayload is the raw AdCP create_media_buy payload, not normalized — render your operator summary from it directly. An approved entry with a null forwardedAt means the upstream forward has not happened yet.

​
Errors

  • 404 NOT_FOUND — no approval entry with that media buy id exists for your storefront.
See Errors for the full error contract.

Decide an approval

Approve or reject this media buy

List approvals

See the pending queue

Media-buy approval tasks

All media-buy approval operations

Media-buy approvals overview

Queue lifecycle and concepts