Calculators

Gross revenue retention (GRR) calculator API

Compute Gross Revenue Retention = (starting - contraction - churn) / starting (excludes expansion, capped at 100%) with a rating (>=95% best-in-class, >=90% healthy, >=85% acceptable) and breakdown. The pure stickiness metric. Answers 'what is my GRR','what is my gross dollar retention','how sticky is my revenue'.

Price$0.01per request

MethodPOST

Route/v1/calc/saas-grr

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

saasgrrgross-revenue-retentionchurnstartupmetricsretentioncalc

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

Integration docs

Example request

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

Example response

{
  "grr": 0.87,
  "grrPercent": 87,
  "rating": "acceptable",
  "formula": "GRR = (starting - contraction - churn) / starting",
  "breakdown": {
    "startingMrr": 100000,
    "contractionMrr": 5000,
    "churnedMrr": 8000
  }
}

Input schema

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

Output schema

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