Two-element [start_date, end_date] window of ISO8601 dates (YYYY-MM-DD); both ends inclusive (the end date's events are counted). Over REST, send it as date_range[]=2026-10-01&date_range[]=2026-10-25.

Filter by store country ISO codes (or "Unknown").

Filter by platform name.

Filter by plan billing period, as an ISO 8601 duration (e.g. P1W, P1M, P1Y).

Filter by subscription plan public_id.

Filter by family-sharing flag ("true"/"false" strings).

Filter by offer type.

Filter by promotional offer public_id.

Filter by audience public_id.

Filter by campaign public_id.

Filter by placement public_id.

Filter by screen (paywall) public_id.

Filter by A/B test variant public_id.

Field selection for token economy: an explicit list of field names to include in the response, or ["*"] for every field. Omit for this endpoint's own default field set.