List reviews

GET /api/v2/storefront/creative-reviews Lists immutable creative versions buyers have submitted to 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.apostra.com/api/v2/storefront/creative-reviews" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

curl "https://api.apostra.com/api/v2/storefront/creative-reviews?status=rejected" \
  -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` rows

Response

[
  {
    "id": "42",
    "reviewRef": "review:42",
    "storefrontId": "1234",
    "creativeId": "cr_abc123",
    "contentDigest": "0db36cf6c4bfb43123aee1c3eaf5ee965e1c34c9df606b02a56c72a226ad097a",
    "mediaBuyId": "mb_2026_q2_ctv",
    "buyerCustomerId": 8801,
    "submittedPayload": {
      "creative_id": "cr_abc123",
      "format": "video",
      "media_url": "https://cdn.acme-brand.example/spots/launch-30s.mp4",
      "account": { "account_id": "acme-buying" },
      "buyer_ref": "launch-q2-sync",
      "context": { "context_id": "ctx_launch_q2" }
    },
    "status": "pending",
    "reviewedBy": null,
    "reviewedAt": null,
    "reviewerNotes": null,
    "createdAt": "2026-06-02T11:00:00Z",
    "updatedAt": "2026-06-02T11:00:00Z"
  }
]

Returns an array of CreativeReviewResponse objects. submittedPayload contains the creative fields plus any request-level account, buyer_ref, and context; buyer webhook configuration is removed. reviewedBy, reviewedAt, and reviewerNotes are null while a row is pending. Each item also returns its nullable delivery state. Do not infer delivery success from status: "approved"; check for delivery.status: "accepted". A failed delivery includes a safe failure code and action-oriented message.

Errors

400 VALIDATION_ERROR — invalid status value.

See Errors for the full error contract.

Get a review

Inspect one creative review row

Decide a review

Approve or reject a pending creative

Creative review tasks

All creative-review operations

Creative reviews 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 a review

Decide a review

Creative review tasks

Creative reviews overview

​Request

​Parameters

​Response

​Errors

​Related

Get a review

Decide a review

Creative review tasks

Creative reviews overview

Request

Parameters

Response

Errors

Related