list_creatives

Overview

Lists creatives visible to the authenticated principal, with optional filters by media buy, status, and format.

Category: Creative Authentication: Required REST equivalent: GET /api/v1/media-buys/{id}/creatives

Parameters

Parameter Type Required Default Description
media_buy_id str or None No None Return only creatives assigned to this media buy.
media_buy_ids list[str] or None No None Return creatives assigned to any of these media buys.
buyer_ref str or None No None Filter by buyer reference.
status str or None No None Filter by status: processing, pending_review, approved, rejected.
format str or None No None Filter by format ID.

Response

Field Type Description
creatives list[Creative] Matching creative objects.

Creative Fields

Field Type Description
creative_id str The creative identifier.
format_id FormatId Format reference (agent_url, id).
name str Creative name.
status str processing, pending_review, approved, or rejected.
assets dict Asset payload.
created_date str (ISO 8601) When the creative was created.
updated_date str (ISO 8601) When the creative was last modified.
provenance Provenance or None Content provenance metadata.

Example

Request:

{
  "media_buy_id": "mb_a1b2c3d4",
  "status": "approved"
}

Response:

{
  "creatives": [
    {
      "creative_id": "cr_video_001",
      "format_id": {"agent_url": "https://creative.example.com", "id": "video_30s"},
      "name": "Acme Sports CTV 30s",
      "status": "approved",
      "assets": {
        "vast_url": "https://cdn.example.com/vast/acme_sports_30s.xml",
        "duration_seconds": 30,
        "resolution": "1920x1080"
      },
      "created_date": "2025-03-15T10:00:00Z",
      "updated_date": "2025-03-15T14:30:00Z",
      "provenance": {
        "digital_source_type": "human_edits",
        "ai_tool": "RunwayML Gen-3",
        "human_oversight": "Creative director reviewed and approved final cut",
        "disclosure": "This advertisement contains AI-generated visual effects."
      }
    }
  ]
}

Further Reading