Skip to main content
Insights are the aggregate numbers on top of everything Alguna bills: net revenue and its recurring and one-off split, revenue movement (new, expansion, contraction, churn), billings by customer and product, customer counts, and accounts-receivable ageing. They are computed from invoices, subscriptions, and payments, so they need no separate data feed. The Revenue Insights dashboard shows them; the Insights API returns the same figures as JSON for your own reporting. Use this page to interpret the dashboard and to find the endpoint for each number. For per-subscription and period-by-period recognised revenue, see Revenue Recognition. For the object model behind the numbers, see How Alguna Works.

Revenue overview

Revenue Insights
  • Total revenue — net revenue over the selected period, with the change against the previous period.
  • Recurring revenue — revenue from recurring products.
  • Non-recurring revenue — revenue from one-off charges.
The chart splits the trend into Fixed (fixed-price products) and Metered (usage-based products), so you can see how much of revenue is consumption. API: GET /insights/revenue returns this month, last month, and annualised figures for net, fixed, and metered revenue, with the one-off portion of each broken out; GET /insights/revenue/over-time returns the series for a date_range. See Get net revenue summary.

Invoices overview

Invoices Overview
Total invoiced over the period, split into the paid and pending (unpaid) portions, and a count of invoices by status — paid, issued, draft, void, and the rest of the invoice statuses. API: GET /insights/billings/over-time returns billed amounts for a date_range; GET /invoices with status and date filters gives the underlying invoices. See Get billings over time.

Top customers

Top Customers
Customers ranked by revenue over the period, with each one’s change against the previous period and share of the total. API: GET /insights/revenue/by-customer and GET /insights/billings/by-customer return the top customers with primary_amount (this period) and comparison_amount (previous period), plus an aggregate for everyone else.

Revenue attribution

Product Attribution
Revenue by product: name, product_type (fixed or metered), earnings, and growth. API: GET /insights/revenue/by-product and GET /insights/billings/by-product, both scoped to a customer_id.

Accounts receivable

Revenue Insights → Accounts Receivables and Invoices → A/R Aging show open balances bucketed by days past due — current, 1–30, 31–60, 61–90, 90+ — in total and per customer. API: GET /insights/ar-aging and GET /insights/ar-aging/by-customer. Field-by-field description on Collections.

Customer metrics

GET /insights/customers returns active, new, churned, and reactivated customer counts for this period and the previous one; GET /insights/customers/over-time returns the series. GET /insights/revenue/breakdown-over-time splits each period’s revenue into new_revenue, expansion_revenue, existing_revenue, contraction_revenue, and churn_revenue.

Insights API reference

All endpoints are GET, return JSON in the organization’s base currency, and have no side effects. date_range is one of this_month, last_month, two_months_ago, this_quarter, last_quarter, two_quarters_ago, this_year, last_year, last_twelve_months, all_time. Generated reference pages start at Get net revenue summary.

Next steps

Revenue Recognition

Deferred and recognised revenue schedules.

Data Exports

Pull the underlying records.