Skip to main content
GET
Get user

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

userId
string
required

Query Parameters

window_days
integer
default:90

How many days back the user profile counts, from the moment of the request. A value below 1 reads as 1, and a value above 365 reads as 365. A decimal is truncated, so 90.7 reads as 90. A non-numeric or empty value uses the default. The response echoes the value it used as window_days.

The default was 365 before September 12, 2026.

Required range: 1 <= x <= 365

Response

Successful response. window_days and sessions_window_days state the windows the numbers cover.

user
object
required

The profile, computed over window_days only. events, sessions, pageviews, and total_value count events inside the window. first_seen and last_seen are the first and last event inside it, so first_seen is not the user's first visit when that visit is older. email, name, and phone are the newest non-empty values in the window. visitor_id, user_id, location, device_type, browser, os, source, medium, campaign, landing_page, and click_id come from the newest event in the window.

sessions
object[]
required

Sessions built from the user's 1000 most recent events inside sessions_window_days, newest first.

conversions
object[]
required

Events named purchase, signup, trial_start, or subscription, plus any event with a value above 0, taken from the same events as sessions.

window_days
integer
required

The window, in days, that user covers. It is the window_days you sent after clamping, or 90 when you sent none or a non-numeric value.

Required range: 1 <= x <= 365
sessions_window_days
integer
required

The window, in days, that sessions and conversions cover. The smaller of window_days and 90.

Required range: 1 <= x <= 90