> For the complete documentation index, see [llms.txt](https://developers.share.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.share.inc/concepts/subscription-states.md).

# Subscription states

> **Placeholder page.** Full content tracked under the docs content effort.

A `Subscription` row holds the active binding between a `Subscriber` and a `Plan`. Its status is computed from the underlying billing record and the current date.

| Status      | Meaning                                               |
| ----------- | ----------------------------------------------------- |
| `PENDING`   | Created, not yet activated (waiting on first payment) |
| `ACTIVE`    | Currently in a paid billing cycle                     |
| `GRACE`     | Cycle ended, grace window still open                  |
| `SUSPENDED` | Grace expired, RADIUS credentials revoked             |
| `CANCELLED` | Cancelled by provider                                 |