Event Stats

Aggregate event analytics: totals by event type, daily trend, top domains, environment breakdowns, uninstall reasons with feedback, and activation/update-adoption rates.

GET /v1/events/stats

Query Parameters

Parameter	Type	Description
product_id	string	Scope to one product
from	string	Window start (YYYY-MM-DD, UTC)
to	string	Window end (YYYY-MM-DD, UTC)
days	number	Rolling window in days (ignored when from/to are set)
reason	string	Scope uninstall feedback + environment breakdowns to one uninstall reason, e.g. switching

Without any window parameters the default is this week (Monday → today, UTC).

Response

{
  "data": {
    "totals": {
      "license.validated": 1320,
      "license.activated": 45,
      "update.checked": 410
    },
    "trend": [
      {
        "date": "2026-06-12",
        "validated": 180,
        "activated": 6,
        "deactivated": 1,
        "updateChecked": 60,
        "installed": 4,
        "uninstalled": 1
      }
    ],
    "topDomains": [
      { "domain": "customer-site.com", "count": 92 }
    ],
    "installTopDomains": [
      { "domain": "new-site.com", "count": 3 }
    ],
    "environment": {
      "php": [{ "bucket": "8.2", "events": 14 }],
      "wp": [{ "bucket": "6.7", "events": 11 }]
    },
    "uninstall": {
      "byReason": [{ "bucket": "switching", "events": 2 }],
      "recentFeedback": [
        {
          "reason": "switching",
          "feedback": "Found a cheaper alternative",
          "domain": "old-site.com",
          "createdAt": "2026-06-11T14:00:00Z"
        }
      ],
      "reason": ""
    },
    "rates": {
      "activationSuccess": 97.8,
      "updateAdoption": 64.2
    },
    "days": 7
  }
}

Field	Description
environment	Install/uninstall environment breakdowns (PHP, WP, OS, server, etc.) bucketed by version.
rates	Percentages; null when there isn't enough data in the window.
days	The window length actually applied.

Example

curl -X GET "https://api.packedge.dev/v1/events/stats?product_id=prd_xxx&days=30" \
  -H "Authorization: Bearer pk_your_api_key"