Subscriptions

The Subscriptions page provides analytics for recurring revenue from Battle Pass, Premium, or VIP subscriptions in your game.

Event Types

Track subscription lifecycle events from your game:

# Player starts a subscription
QuestData.track("subscription_started", {
  "plan_id": "battle_pass",
  "mrr": 4.99,
  "currency": "USD"
})

# Subscription renews automatically
QuestData.track("subscription_renewed", {
  "plan_id": "battle_pass",
  "mrr": 4.99
})

# Player cancels
QuestData.track("subscription_cancelled", {
  "plan_id": "battle_pass",
  "mrr": 4.99,
  "reason": "too_expensive"
})

KPI Cards

Metric	Description
Active Subs	Currently active subscriptions (started + renewed - cancelled)
MRR	Monthly Recurring Revenue from all active subscriptions
Churn Rate	Percentage of subscriptions cancelled vs total
MRR Growth	Net change in MRR (new + renewed - cancelled)
New Subscriptions	New subscriptions started in the period
Renewals	Subscriptions that renewed in the period
Cancelled	Subscriptions cancelled in the period

MRR Timeline

A stacked bar chart showing monthly MRR movement:

• Green bars: New MRR from starts and renewals
• Red bars: Churned MRR from cancellations

Plan Distribution

A doughnut chart showing subscriber distribution across plans (e.g., Battle Pass vs Premium vs VIP).

Plan Performance Table

Detailed breakdown by plan:

• Plan name
• Number of subscribers
• Total revenue generated

API Reference

curl "https://api.questdata.io/v1/stats/subscriptions?from=2026-01-01&to=2026-04-01" \
  -H "x-game-api-key: YOUR_API_KEY"

Response:

{
  "summary": {
    "active_subscriptions": 25,
    "total_mrr": 249.75,
    "new_subscriptions": 10,
    "renewals": 6,
    "cancelled": 3,
    "churn_rate": 18.8,
    "mrr_growth": 199.80
  },
  "mrrTimeline": [
    { "month": "2026-03-01", "new_mrr": 200.0, "churned_mrr": 50.0, "net_mrr": 150.0 }
  ],
  "plans": [
    { "plan_id": "battle_pass", "subscribers": 15, "revenue": 74.85 },
    { "plan_id": "premium", "subscribers": 8, "revenue": 79.92 }
  ]
}