URL: /revenue/contraction-arr · Id: `page:/revenue/contraction-arr`

# Downgrades: what moves it

> Downgrades is the ARR lost from Customers who still pay, but less than in the last window.

No [Play](https://startupbuilder.dev/business/nouns/play) moves this yet. Today the hub runs `change-plan`; the proposed Play is `downgrade-save` (Not live yet, gaps #4).

## The number

```text title="Downgrades · Ask"
What moved downgrades this week, and which Play moved it?
```

```ts title="Downgrades · SDK"
import { $ } from 'startup-builder'

const { total } = await $.Event.list({ where: 'name = "Subscription.resized" and at >= "2026-10-12"', total: true })   // seat and plan changes down; Willow Park’s 10 to 6 lands Nov 1
return await $.Metric.query({ metric: 'contraction-arr', shape: 'trend', breakdown: 'play', window: '7d' })   // by the Play credited · Not live yet, gaps #4
```

```json title="Downgrades · Response · sample"
{
  "metric": {
    "$id": "https://api.sb/leaseline.app/metrics/contraction-arr",
    "$type": "Metric",
    "name": "Contraction ARR"
  },
  "week": "2026-10-19",
  "value": 0,
  "rows": [],
  "pending": [
    {
      "customer": "customers/customer_12",
      "from": 10,
      "to": 6,
      "on": "2026-11-01",
      "value": -1388
    }
  ]
}
```

`$0 ARR from downgrades · ■■■■ Clear · n 0 · next: −$1,388 ARR on Nov 1`

`$.Metric.query({ metric: 'contraction-arr', shape: 'trend', breakdown: 'play', window: '7d' })` · sample

Nothing moved it in the window: `$0 ARR`.

`contraction-arr` is this site’s proposal to the hub (Not live yet, [gaps #4](/code/reference#not-live-yet)), so the figure above is a sample until the hub holds it.

## Owner
| Accountable | From |
| --- | --- |
| [`customer-lead`](https://startupbuilder.dev/agents/customer/customer-lead) · Customer Lead | the filed bridge item, word for word |

## Worked by
| Title | Its queue |
| --- | --- |
| [CSM](/capabilities/how-your-agents-act#csm) | <Op verb="Task.next" /> on the CSM’s queue |

## Moved here by
| How | Where |
| --- | --- |
| Today | the hub Workflow [`change-plan`](https://startupbuilder.dev/workflows/processes/plan-changes/change-plan) · Change a plan |
| Proposed Play | `downgrade-save` · Not live yet, [gaps #4](/code/reference#not-live-yet) |
| Page | [More seats and upgrades](/revenue/upgrades-and-seats) |
| Page | [When someone cancels](/revenue/cancel-and-save) |
| Title | [CSM](/capabilities/how-your-agents-act#csm) |

## The leaves
| Under it | Moved by |
| --- | --- |
| none | no leaf Metric sits under it; its Plays move it directly |