List approvals

GET /api/v2/storefront/media-buy-approvals Lists approval-queue entries for your storefront, newest first. Pending entries are ordered by submission time; decided history is ordered by review time. Defaults to status=pending — the operator queue — so you do not have to thread the filter manually. Pass ?status= to see decided history and ?take= to limit the number returned.

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&take=20" \
  -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
`take`	integer	No	Query param — return at most this many newest entries. Minimum `1`, maximum `100`

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",
    "readiness": {
      "packages": [
        {
          "mediaProductId": "ctv-run-of-network",
          "buyerRef": "mb_2026_q2_ctv_pkg_ctv",
          "assignedCreativeIds": [],
          "unusableCreatives": [
            {
              "creativeId": "cr_audio_15s",
              "reason": "slot \"audio\" requires a duration of at least 30000ms but asset is 15047ms"
            }
          ],
          "unusableCreativeCount": 1,
          "compatibleUnattachedCreativeIds": [],
          "compatibleUnattachedCreativeCount": 0
        }
      ],
      "packageCount": 1,
      "creativelessPackageCount": 1,
      "creativeSyncFailures": [],
      "creativeSyncFailureCount": 0
    }
  }
]

Each element is a full PendingMediaBuyResponse. reviewedBy, reviewedAt, reviewerNotes, and forwardedAt are null while an entry is pending. Without take, this endpoint returns all matching entries without pagination. readiness reports whether the buy can actually deliver — see Delivery readiness. It is null on decided entries, on update approvals, and when the check could not run.

Errors

400 VALIDATION_ERROR — invalid status or take 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

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

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