Skip to content

What a customer is worth: ARPA, monthly churn, 12-month LTV

GET
/v1/revenue/economics

Per currency: paying customers, MRR, ARPA (MRR per paying customer), monthly customer churn measured over the last 90 days (or the plan’s history if shorter; customers_at_start and churned show the base), and ltv_12m_minor = ARPA × (1 − (1 − churn)^12) ÷ churn, or 12 × ARPA with no churn. low_confidence is true under five customers. Compare LTV with a source’s cost per paying customer (GET /v1/attribution with costs) for LTV:CAC. Amounts are in the smallest currency unit, reported per currency, and never converted or added together. Every response includes sync (status, last_synced_at, livemode): backfilling means the first import is still running, revoked or error means the numbers are as of the last successful sync.

Auth: Secret key only. Every plan with Stripe connected.

Economics

Error envelope. See error.code for the discriminator.

object
data
required
null
error
required
object
code
required
string
message
required
string
remediation
required
string
doc_url
string format: uri
param
string
request_id
string
meta
object
key
additional properties

Error envelope. See error.code for the discriminator.

object
data
required
null
error
required
object
code
required
string
message
required
string
remediation
required
string
doc_url
string format: uri
param
string
request_id
string
meta
object
key
additional properties

STRIPE_NOT_CONNECTED: connect Stripe or Lemon Squeezy in the dashboard first.

object
data
required
null
error
required
object
code
required
string
message
required
string
remediation
required
string
doc_url
string format: uri
param
string
request_id
string
meta
object
key
additional properties