Skip to main content
GET
Get user lifecycle
Returns the visitors in each lifecycle stage. The window options are whole days from 1 to 90. Two rules apply:
  • at_risk_min_days_inactive is less than churn_window_days.
  • at_risk_prior_active_days is at most prior_window_days.
See audience insights and the stage definitions.

Authorizations

Authorization
string
header
required

An API key (mana_api_...) with scopes. It reads reports and writes profile properties.

Path Parameters

projectId
string<uuid>
required

The project ID

Query Parameters

date_from
string

First day (UTC) as YYYY-MM-DD. Default: 29 days before date_to.

Pattern: ^\d{4}-\d{2}-\d{2}$
date_to
string

Last day (UTC) as YYYY-MM-DD. Default: today. The range is at most 367 days.

Pattern: ^\d{4}-\d{2}-\d{2}$
page_path
string

Only events on this page path

Maximum string length: 2048
Pattern: ^\/
utm_source
string
Maximum string length: 255
utm_medium
string
Maximum string length: 255
utm_campaign
string
Maximum string length: 255
utm_content
string
Maximum string length: 255
utm_term
string
Maximum string length: 255
ref
string

Referral code (ref link parameter)

Maximum string length: 255
paid_source
enum<string>

Ad network of a paid click

Available options:
google,
meta,
microsoft,
tiktok,
twitter,
linkedin,
reddit,
snapchat,
paid_utm
click_id
string

Ad click ID (gclid, fbclid and others)

Maximum string length: 255
channel_type
enum<string>

Acquisition channel

Available options:
Paid Search,
Paid Video,
Paid Social,
Paid Other,
Email,
Referrals,
Display,
AI,
Organic Search,
Organic Social,
Organic Video,
Referrers,
Direct
referrer
string

Referrer origin, for example https://www.reddit.com

Maximum string length: 2048
locale
string
Maximum string length: 32
device
enum<string>
Available options:
desktop,
mobile,
tablet,
bot
os
enum<string>
Available options:
windows,
macos,
ios,
android,
linux,
other
browser
enum<string>
Available options:
chrome,
safari,
firefox,
edge,
opera,
other
country
string

ISO 3166-1 alpha-2 country code

Pattern: ^[A-Za-z]{2}$
currency
string

Report currency for revenue (ISO 4217). Default: USD.

Pattern: ^[A-Z]{3}$
currency_mode
enum<string>

convert (default) converts other currencies with the rate of the event day. only counts the report currency alone.

Available options:
convert,
only
filters
string

Operator filters as a JSON array of { "field", "op", "value" }, combined with AND. At most 20.

Maximum string length: 8192
new_window_days
string

Default: 30

Pattern: ^\d{1,2}$
churn_window_days
string

Default: 30

Pattern: ^\d{1,2}$
prior_window_days
string

Default: 30

Pattern: ^\d{1,2}$
resurrected_gap_days
string

Default: 30

Pattern: ^\d{1,2}$
at_risk_min_days_inactive
string

Default: 14. Less than churn_window_days.

Pattern: ^\d{1,2}$
at_risk_prior_active_days
string

Default: 1. At most prior_window_days.

Pattern: ^\d{1,2}$

Response

The report

date_from
string
required

First day of the report

Pattern: ^\d{4}-\d{2}-\d{2}$
date_to
string
required

Last day of the report

Pattern: ^\d{4}-\d{2}-\d{2}$
rows
object[]
required