@adcp/client API Reference - v4.19.0
    Preparing search index...

    Interface CreativeFilters

    Filter criteria for querying creatives from a creative library. By default, archived creatives are excluded from results. To include archived creatives, explicitly filter by status='archived' or include 'archived' in the statuses array.

    interface CreativeFilters {
        accounts?: AccountReference[];
        statuses?: CreativeStatus[];
        tags?: string[];
        tags_any?: string[];
        name_contains?: string;
        creative_ids?: string[];
        created_after?: string;
        created_before?: string;
        updated_after?: string;
        updated_before?: string;
        assigned_to_packages?: string[];
        media_buy_ids?: string[];
        unassigned?: boolean;
        has_served?: boolean;
        concept_ids?: string[];
        format_ids?: FormatID[];
        has_variables?: boolean;
    }
    Index

    Properties

    accounts? statuses? tags? tags_any? name_contains? creative_ids? created_after? created_before? updated_after? updated_before? assigned_to_packages? media_buy_ids? unassigned? has_served? concept_ids? format_ids? has_variables?

    Properties

    accounts?: AccountReference[]

    Filter creatives by owning accounts. Useful for agencies managing multiple client accounts.

    statuses?: CreativeStatus[]

    Filter by creative approval statuses

    tags?: string[]

    Filter by creative tags (all tags must match)

    tags_any?: string[]

    Filter by creative tags (any tag must match)

    name_contains?: string

    Filter by creative names containing this text (case-insensitive)

    creative_ids?: string[]

    Filter by specific creative IDs

    created_after?: string

    Filter creatives created after this date (ISO 8601)

    created_before?: string

    Filter creatives created before this date (ISO 8601)

    updated_after?: string

    Filter creatives last updated after this date (ISO 8601)

    updated_before?: string

    Filter creatives last updated before this date (ISO 8601)

    assigned_to_packages?: string[]

    Filter creatives assigned to any of these packages. Sales-agent-specific — standalone creative agents SHOULD ignore this filter.

    media_buy_ids?: string[]

    Filter creatives assigned to any of these media buys. Sales-agent-specific — standalone creative agents SHOULD ignore this filter.

    unassigned?: boolean

    Filter for unassigned creatives when true, assigned creatives when false. Sales-agent-specific — standalone creative agents SHOULD ignore this filter.

    has_served?: boolean

    When true, return only creatives that have served at least one impression. When false, return only creatives that have never served.

    concept_ids?: string[]

    Filter by creative concept IDs. Concepts group related creatives across sizes and formats (e.g., Flashtalking concepts, Celtra campaign folders, CM360 creative groups).

    format_ids?: FormatID[]

    Filter by structured format IDs. Returns creatives that match any of these formats.

    has_variables?: boolean

    When true, return only creatives with dynamic variables (DCO). When false, return only static creatives.

    Settings

    Member Visibility

    On This Page

    Properties