Get a review

GET /api/v2/storefront/creative-reviews/{creativeId} Fetches one creative review row. Use the collision-free reviewRef returned by the review queue so the request identifies one buyer and one immutable content version. The legacy numeric id remains in responses, but is not a bare path reference. Bare path values always select the AdCP creative-id namespace, including when numeric; creative:<id> is the explicit equivalent. The response includes the submitted payload, current status, and any decision you recorded. It also includes delivery, the separate buy-scoped delivery state; an approved review can have a failed delivery that still needs action.

Request

curl "https://api.apostra.com/api/v2/storefront/creative-reviews/review%3A42" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	Type	Required	Notes
`creativeId`	string	Yes	Path param — use the `reviewRef` returned by the queue. Bare values always select an AdCP creative id, including when numeric

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" }
  },
  "previewContexts": [
    {
      "contextRef": "75c90dd1-2430-4f2e-9bd0-c029f91ad5f7",
      "buyerPackageId": "homepage-display",
      "placement": {
        "kind": "publisher",
        "publisherDomain": "publisher.example",
        "placementId": "homepage-hero"
      }
    }
  ],
  "status": "pending",
  "reviewedBy": null,
  "reviewedAt": null,
  "reviewerNotes": null,
  "createdAt": "2026-06-02T11:00:00Z",
  "updatedAt": "2026-06-02T11:00:00Z"
}

Returns the matching CreativeReviewResponse. mediaBuyId is null when the buyer attached the creative independently of a media buy. submittedPayload is the immutable, credential-stripped submission snapshot: it contains the creative object and may contain request-level account, buyer_ref, and context. Those three request-level fields do not contribute to contentDigest. push_notification_config and pushNotificationConfig are stored separately and are never returned in this response. previewContexts contains only current, unambiguous package and placement bindings. Use its opaque contextRef with the preview endpoint; an empty array means the row remains source-inspection only. delivery is null when there is no current delivery context. Otherwise its status is waiting_for_route, processing, accepted, failed, or superseded. A failed delivery includes a safe failure.code and message; format_translation_failed means the seller catalogue and product route must be refreshed before retrying.

Errors

409 CONFLICT — the creative id matches multiple buyers or content versions; retry with reviewRef.
404 NOT_FOUND — no creative review row with that id exists for your storefront.

See Errors for the full error contract.

Decide a review

Approve or reject this creative

Preview a review

Resolve the safest available placement-aware preview

List reviews

Find creatives in the queue

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

Decide a review

Preview a review

List reviews

Creative review tasks

Creative reviews overview

​Request

​Parameters

​Response

​Errors

​Related

Decide a review

Preview a review

List reviews

Creative review tasks

Creative reviews overview

Request

Parameters

Response

Errors

Related