Analytics
The analytics endpoints return computed insights so an agent does not have to list and aggregate records itself. They require only theread scope and report money per currency — amounts are never converted across currencies, so figures are always exact.
Spend summary
GET /api/v1/analytics/summary (available on Free and Premium)
- Paid
activesubscriptions (isTrial: false) contribute tobyCurrencyandbyCategory. Active free trials (isTrial: true) are counted incounts.trials(as part ofcounts.active) and appear inupcomingRenewalswith"isTrial": true, without inflating current recurring spend totals before their first paid charge. - Overdue
activenon-trial subscriptions automatically advancenextPaymentDateto the current billing cycle before computingupcomingRenewalsanddaysUntilRenewal. Free trials (isTrial: true) do not auto-advance. - Custom billing intervals (
period: "custom",customDate: "<days>") annualize usingamount × (365 / days)and divide by12for monthly equivalents, matching the web dashboard and reports. - Totals are grouped by currency; do not sum across currencies.
Duplicate detection (Premium)
GET /api/v1/analytics/duplicates
[!IMPORTANT]
Requires Lifetime Premium. Calling this endpoint on a Free account returns 403 premium_required.
Returns groups of non-cancelled subscriptions that share a normalized name (case- and whitespace-insensitive) — a strong signal of duplicate tracking or double billing.
Optimization candidates (Premium)
GET /api/v1/analytics/optimizations
[!IMPORTANT]
Requires Lifetime Premium. Calling this endpoint on a Free account returns 403 premium_required.
Returns factual candidates with no invented discount rates:
monthlyToAnnual— active monthly subscriptions with their current annualized cost (yearlyAtCurrentRate = monthlyAmount × 12).aboveAverageInCurrency— subscriptions whose monthly-equivalent cost exceeds twice the average for their currency.