@adcp/sdk API Reference - v7.9.0
    Preparing search index...

    Interface GetMediaBuyArtifactsRequest

    Request parameters for retrieving content artifacts from a media buy for validation

    interface GetMediaBuyArtifactsRequest {
        adcp_major_version?: number;
        account?: AccountReference;
        media_buy_id: string;
        package_ids?: string[];
        failures_only?: boolean;
        time_range?: { start?: string; end?: string };
        pagination?: { max_results?: number; cursor?: string };
        context?: ContextObject;
        ext?: ExtensionObject;
    }
    Index

    Properties

    adcp_major_version?: number

    The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.

    1

    99

    media_buy_id: string

    Media buy to get artifacts from

    package_ids?: string[]

    Filter to specific packages within the media buy

    failures_only?: boolean

    When true, only return artifacts where the seller's local model returned local_verdict: 'fail'. Useful for auditing false positives. Not useful when the seller does not run a local evaluation model (all verdicts are 'unevaluated').

    time_range?: { start?: string; end?: string }

    Filter to specific time period

    Type Declaration

    • Optionalstart?: string

      Start of time range (inclusive)

      date-time

    • Optionalend?: string

      End of time range (exclusive)

      date-time

    pagination?: { max_results?: number; cursor?: string }

    Pagination parameters. Uses higher limits than standard pagination because artifact result sets can be very large.

    Type Declaration

    • Optionalmax_results?: number

      Maximum number of artifacts to return per page

      1

      10000

    • Optionalcursor?: string

      Opaque cursor from a previous response to fetch the next page

    context?: ContextObject
    ext?: ExtensionObject