---
title: "Get user lifecycle stages (New / Returning / Power user / At Risk / Churned / Resurrected)"
method: GET
path: "/v0/lifecycle"
tags: ["Query"]
---

# Get user lifecycle stages (New / Returning / Power user / At Risk / Churned / Resurrected)

`GET /v0/lifecycle`

## Request

- Base URL: `https://api.formo.so`
- URL: `https://api.formo.so/v0/lifecycle`
- Auth: HTTP bearer

Counts wallet users by lifecycle stage based on activity within the date range. The reference date is `date_to`.

Default stage thresholds can be overridden per-request with the lifecycle threshold query params (`new_window_days`, `churn_window_days`, `power_user_min_active_days`, `power_user_window_days`, `resurrected_gap_days`, `at_risk_min_days_inactive`, `at_risk_prior_active_days_threshold`); each is an optional integer 1 to 90. When omitted, the project's saved Settings → Lifecycle values apply, then the platform defaults.

## Query parameters

- `date_from` string, date
- `date_to` string, date
- `filters` string
- `include_previous_period` boolean
- `behavior_filters` string
- `source_filter` string
- `channel_filter` string
- `new_window_days` integer
- `churn_window_days` integer
- `power_user_min_active_days` integer
- `power_user_window_days` integer
- `resurrected_gap_days` integer
- `at_risk_min_days_inactive` integer
- `at_risk_prior_active_days_threshold` integer

## Response `200`

Lifecycle counts

- AnalyticsResponse: Analytics endpoint response. The `data` array contains the rows; the exact row shape depends on the endpoint. `meta` carries column type information for rendering, `rows` is the row count, and `statistics` holds query timing metadata.
  - `data` object[]
  - `meta` object[]
    - `name` string
    - `type` string
  - `rows` integer
  - `rows_before_limit_at_least` integer
  - `statistics` object

## Other responses

- `401`: Invalid API key
- `403`: Insufficient permissions

---

[API](https://skmtc.dev/formo/apis/formo-public-api.md) · [All operations](https://skmtc.dev/formo/apis/formo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/formo/apis/formo-public-api/revisions/67ada57df63c?raw)