Calculators

Net revenue retention (NRR) calculator API

Compute Net Revenue Retention = (starting + expansion - contraction - churn) / starting over an existing cohort (excludes new logos) with a rating (>=120% best-in-class, >=110% excellent, >=100% good) and breakdown. Answers 'what is my NRR','what is my net dollar retention','is my cohort expanding'.

Price$0.01per request

MethodPOST

Route/v1/calc/saas-nrr

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

saasnrrnet-revenue-retentionexpansionstartupmetricsretentioncalc

API URLhttps://x402.hexl.dev/v1/calc/saas-nrr

Integration docs

Example request

{
  "startingMrr": 100000,
  "expansionMrr": 20000,
  "contractionMrr": 5000,
  "churnedMrr": 8000
}

Example response

{
  "nrr": 1.07,
  "nrrPercent": 107,
  "rating": "good",
  "formula": "NRR = (starting + expansion - contraction - churn) / starting",
  "breakdown": {
    "startingMrr": 100000,
    "expansionMrr": 20000,
    "contractionMrr": 5000,
    "churnedMrr": 8000,
    "endingCohortMrr": 107000
  }
}

Input schema

{
  "type": "object",
  "required": [
    "startingMrr",
    "expansionMrr",
    "contractionMrr",
    "churnedMrr"
  ],
  "properties": {
    "startingMrr": {
      "type": "number",
      "description": "cohort starting MRR (currency)",
      "examples": [
        100000
      ]
    },
    "expansionMrr": {
      "type": "number",
      "description": "expansion MRR from cohort (currency)",
      "examples": [
        20000
      ]
    },
    "contractionMrr": {
      "type": "number",
      "description": "contraction MRR (currency)",
      "examples": [
        5000
      ]
    },
    "churnedMrr": {
      "type": "number",
      "description": "churned MRR (currency)",
      "examples": [
        8000
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}