List approvals

GET /api/v2/storefront/media-buy-approvals Lists approval-queue entries for your storefront, newest first. Defaults to status=pending — the operator queue — so you do not have to thread the filter manually. Pass ?status= to see decided history.

Request

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

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

Parameters

Field	Type	Required	Notes
`status`	enum	No	Query param — `pending`, `approved`, `rejected`, or `revoked`. Omit to return only `pending` entries

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": "pending",
    "reviewedBy": null,
    "reviewedAt": null,
    "reviewerNotes": null,
    "forwardedAt": null,
    "createdAt": "2026-06-02T10:00:00Z",
    "updatedAt": "2026-06-02T10:00:00Z"
  }
]

Each element is a full PendingMediaBuyResponse. reviewedBy, reviewedAt, reviewerNotes, and forwardedAt are null while an entry is pending. This endpoint returns all matching entries without pagination.

Errors

400 VALIDATION_ERROR — invalid status value.

See Errors for the full error contract.

Get an approval

Inspect one queue entry

Decide an approval

Approve or reject a pending media buy

Media-buy approval tasks

All media-buy approval operations

Media-buy approvals overview

Queue lifecycle and concepts

Get an approval Retry forwarding

⌘I

Getting Started

Operating Your Storefront

Inventory Sources

Real-Time Targeting (TMP)

Approvals & Reviews

Buyer Onboarding

Demand & Signals

Proposals & Agents

Buyer Routing

Analytics & Activity

Billing

Account

Request

Parameters

Response

Errors

Get an approval

Decide an approval

Media-buy approval tasks

Media-buy approvals overview

​Request

​Parameters

​Response

​Errors

​Related

Get an approval

Decide an approval

Media-buy approval tasks

Media-buy approvals overview

Request

Parameters

Response

Errors

Related