Skip to content

Revenue and lifetime value

Motenya adds up orders and subscription invoices into revenue figures, per customer and per product.

  • Paid: orders that were not canceled or refunded, with payment status paid or none at all. Orders whose source never reports payment count as paid.
  • Outstanding: orders not canceled or refunded that are unpaid or partially_paid. A partly paid order counts in full, since only its status is known.
  • Overdue: outstanding past its dueAt.
  • Monthly recurring revenue (MRR): active and past-due subscriptions that have not ended, each converted to a monthly amount (a yearly plan counts a twelfth).

Amounts are per currency and never converted. Months are calendar months in UTC ("2026-11"), and revenue falls in the month it was paid (or placed, when no payment date is known).

GET /v1/products/{productId}/insights/customer?clientId=… (or contactId=…) returns the lifetime value, outstanding and overdue amounts, order count, first and last purchase, MRR, and paid revenue per month for the last months months (default 12, up to 36).

GET /v1/products/{productId}/insights/overview?months=12 returns paid revenue per month, all-time revenue, outstanding and overdue amounts, MRR, the number of active subscriptions, subscriptions started and canceled per month, and the ten customers who paid the most.

Both need crm:read.