OptionalaccountOptionalmedia_Array of media buy IDs to retrieve. When omitted, returns a paginated set of accessible media buys matching status_filter.
Optionalstatus_Filter by status. Can be a single status or array of statuses. Defaults to ["active"] when media_buy_ids is omitted. When media_buy_ids is provided, no implicit status filter is applied.
Optionalinclude_When true, include a near-real-time delivery snapshot for each package. Snapshots reflect the latest available entity-level stats from the platform (e.g., updated every ~15 minutes on GAM, ~1 hour on batch-only platforms). The staleness_seconds field on each snapshot indicates data freshness. If a snapshot cannot be returned, package.snapshot_unavailable_reason explains why. Defaults to false.
Optionalinclude_When present, include the last N revision history entries for each media buy (returns min(N, available entries)). Each entry contains revision number, timestamp, actor, and a summary of what changed. Omit or set to 0 to exclude history (default). Recommended: 5-10 for monitoring, 50+ for audit.
OptionalpaginationOptionalcontextOptionalext
Request parameters for retrieving media buy status, creative approval state, and optional delivery snapshots