> 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/subscriber-lifecycle.md).

# Subscriber lifecycle

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

A subscriber moves through these states over their relationship with the provider:

```mermaid
stateDiagram-v2
  [*] --> Created
  Created --> Active: first successful payment
  Active --> Suspended: grace period expired
  Suspended --> Active: payment received
  Active --> Cancelled: cancelled by provider
  Suspended --> Cancelled: cancelled by provider
```

Subscriber status is **derived** from the active subscription, not stored on the subscriber row itself. The API exposes the derived status on every read.