Sign in

v64

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-03124241726.5 KB
Users

Get project end-user overview

Returns project-wide end-user aggregates over the range — unique and new users, identified vs total traces and sessions — plus a per-bucket activity histogram. The range defaults to the trailing 30 days.

get/v1/projects/{projectSlug}/users/overview

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

Project slug (human-readable identifier)

Query parameters

fromIsostring date-time

Lower bound (inclusive) of the time range. Defaults to 30 days before toIso.

Lower bound (inclusive) of the time range. Defaults to 30 days before toIso.

toIsostring date-time

Upper bound (inclusive) of the time range. Defaults to now.

Upper bound (inclusive) of the time range. Defaults to now.

Response

Users overview

uniqueUsersinteger required

Distinct identified users with at least one trace in the range.

newUsersinteger required

Users whose first trace ever falls inside the range.

identifiedTracesinteger required

Traces in the range carrying a non-empty user_id.

totalTracesinteger required

All traces in the range, identified or not.

identifiedSessionsinteger required

Distinct sessions in the range carrying a non-empty user_id.

totalSessionsinteger required

All distinct sessions in the range, identified or not.

bucketSecondsinteger required

Bucket width the histogram was computed with, in seconds.

fromIsostring required

ISO-8601 lower bound of the resolved range.

toIsostring required

ISO-8601 upper bound of the resolved range.