New, returning, resurrected and dormant visitors
Per day, week (default) or month: visitors first seen then, active in the period before too, back after a gap, and gone since the period before.
An API token from POST /v2/tokens (at_live_...), or a project's secret key (sk_...) for server-side ingest.
In: header
Path Parameters
The project id, as listed by GET /v2/projects.
1 <= lengthQuery Parameters
Start of the range; send with to.
date-timeEnd of the range, exclusive.
date-timeA range ending at the start of today in UTC (24h ends at the start of this hour). Ignored when from and to are sent; 30d by default.
Value in
- "24h"
- "7d"
- "30d"
- "90d"
- "12mo"
- "all"
Which traffic is counted. human (the default) leaves out bot scores of 50 and up, your own visits and localhost; bots keeps only scores of 50 and up; internal keeps only your own visits; all keeps everything.
Value in
- "human"
- "bots"
- "internal"
- "all"
production (the default) leaves preview deployments out, preview keeps only them, all keeps both.
Value in
- "production"
- "preview"
- "all"
Sent as filter[<dimension>]=value, or !value to exclude; repeatable across dimensions.
Period size in UTC: day, week (the default, starting Monday) or month.
Value in
- "day"
- "week"
- "month"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/projects/string/lifecycle"{ "data": [ { "period": "2019-08-24T14:15:22Z", "new": 0, "returning": 0, "resurrected": 0, "dormant": 0 } ], "interval": "day", "range": { "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z" }, "traffic": "human", "environment": "production", "filters": {}}