Skip to main content

Analytics

The analytics endpoints return computed insights so an agent does not have to list and aggregate records itself. They require only the read 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 active subscriptions (isTrial: false) contribute to byCurrency and byCategory. Active free trials (isTrial: true) are counted in counts.trials (as part of counts.active) and appear in upcomingRenewals with "isTrial": true, without inflating current recurring spend totals before their first paid charge.
  • Overdue active non-trial subscriptions automatically advance nextPaymentDate to the current billing cycle before computing upcomingRenewals and daysUntilRenewal. Free trials (isTrial: true) do not auto-advance.
  • Custom billing intervals (period: "custom", customDate: "<days>") annualize using amount × (365 / days) and divide by 12 for 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.
This matches by name only; overlapping but differently named services are not detected.

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.
Present these figures to the user and let them decide; the API reports current costs, not negotiated savings.