CARR (Contracted Annual Recurring Revenue): Annual Recurring Revenue (ARR) plus the annual recurring value of contracts that are signed and have not yet started, as of period end. Also called Committed ARR. Committed Monthly Recurring Revenue (CMRR) is the same figure stated monthly.
Also known as: CARR
Formula
CARR = ARR + Contracted ARR not yet startedCARR net of known churn = CARR - (Temporary MRR still running × 12) - ACV of cancellations yet to take effect
CARR net of forecast churn = CARR - Renewal forecast shortfall Computable definition
The canonical formula in the GASP formula grammar. The MCP server compiles it to SQL over the datasets listed below.
metric.arr + sum(field.acv where field.contract_event_type = 'new_contract' and field.contract_start > period_end) to_date Unit: currency
- Net of known churn variant
metric.arr + sum(field.acv where field.contract_event_type = 'new_contract' and field.contract_start > period_end) to_date - 12 * sum(field.mrr_change where ((field.change_nature = 'temporary' and field.event_type in ('new', 'expansion', 'reactivation')) or (field.change_nature = 'scheduled_reversal' and field.event_type in ('contraction', 'churn'))) and (field.expansion_classification is null or field.expansion_classification != 'usage_realisation')) to_date - sum(field.acv where field.contract_event_type = 'cancellation' and field.contract_end > period_end) to_date- Net of forecast churn variant
metric.arr + sum(field.acv where field.contract_event_type = 'new_contract' and field.contract_start > period_end) to_date - sum(max(field.mrr * 12 - field.forecast_renewal_amount, 0) where field.subscription_status = 'active' and field.contract_end > period_end and field.forecast_renewal_amount is not null)
Notes: Contracted ARR, also called Committed ARR: ARR plus the annual contract value of each new contract signed on or before period end whose start date is later. The SaaS Metrics Standards Board formula, (MRR x 12) + contracted but not yet recognised ARR. A contract leaves the second term on its start date and enters ARR through MRR, so it is counted once. Churn and downgrades come off through ARR on the day they take effect, as the Board states, never on notice. ACV is recurring only and one year of a multi-year agreement. An upgrade or a renewal uplift signed for a later date enters when it takes effect.
Data requirements
Grain: End-of-month snapshot · Frequency: Monthly · Aggregation: snapshot (month) · Staged: no · Main source: Billing.
| Field | Dataset | Type |
|---|---|---|
acv | contract_event | decimal |
contract_event_type | contract_event | string |
contract_start | contract_event | date |
event_date | contract_event | date |
mrr | subscription | decimal |
snapshot_date | subscription | date |
subscription_status | subscription | string |
Example SQL (Postgres)
SELECT (((((SELECT COALESCE(SUM(mrr), 0) FROM subscription WHERE snapshot_date = :period_end AND subscription_status = 'active')) * 12)) + (SELECT COALESCE(SUM(acv), 0) FROM contract_event WHERE event_date <= :period_end AND (contract_event_type = 'new_contract' AND contract_start > :period_end))) AS carr Access: recommended
sensitivity tier confidential,
access scope unscoped.
Guidance your policy engine enforces.
From an agent: with the GASP MCP server, call
lookup_metric({ "name": "CARR (Contracted Annual Recurring Revenue)" }) or generate_query({ "metric": "CARR (Contracted Annual Recurring Revenue)", "adapter": "<your adapter JSON>" }).
What It Tells You
The recurring revenue customers have signed for, started or not. A gap that grows faster than ARR shows sales closing faster than contracts start.
Common Mistakes
- Reporting Bookings as CARR: Bookings carry total contract value, every year of a multi-year agreement and services
- Deducting a customer's revenue when notice arrives and reporting the result as CARR, which is the figure net of known churn
- Adding the deductions of the two variants together
- Counting a contract in both terms after it starts
Related Metrics
Connected in the GASP relationship graph.
Upstream: what drives this
- ARR component of CARR (Core)
Downstream: what this drives
- CARR measures Customer (Entity)
- CARR measures Subscription (Entity)