Skip to content

Get Day Profile

GET
/users/{user_id}/insights/day-profile
curl --request GET \
--url 'https://example.com/users/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/insights/day-profile?window_days=90'

The shape of a good day vs a bad day: contrast the user’s best- and worst-rated days (top vs bottom tercile of day_sentiment) and rank what separates them — behaviours you control first. Deterministic, query-time, Cliff’s-delta effect size; association not causation; no LLM. Returns an empty profile when there aren’t enough sentiment-rated days to form two terciles.

user_id
required
User Id
string format: uuid
window_days
Window Days
integer
default: 90 >= 14 <= 365

Successful Response

Media typeapplication/json
DayProfileResponse

The ‘shape of a good day vs a bad day’ contrast (Track G). features is empty when there aren’t enough sentiment-rated days to form two terciles.

object
bad_days
required
Bad Days
integer
bad_threshold
required
Any of:
number
features
required
Features
Array<object>
ProfileFeatureCard

One feature separating a user’s good days from bad days. See services/day_profile.py.

object
bad_median
required
Bad Median
number
bad_rate
required
Any of:
number
delta
required
Delta
number
direction
required
Direction
string
good_median
required
Good Median
number
good_rate
required
Any of:
number
key
required
Key
string
kind
required
Kind
string
label
required
Label
string
n_bad
required
N Bad
integer
n_good
required
N Good
integer
unit
required
Unit
string
good_days
required
Good Days
integer
good_threshold
required
Any of:
number
window_days
required
Window Days
integer
Examplegenerated
{
"bad_days": 1,
"bad_threshold": 1,
"features": [
{
"bad_median": 1,
"bad_rate": 1,
"delta": 1,
"direction": "example",
"good_median": 1,
"good_rate": 1,
"key": "example",
"kind": "example",
"label": "example",
"n_bad": 1,
"n_good": 1,
"unit": "example"
}
],
"good_days": 1,
"good_threshold": 1,
"window_days": 1
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
"detail": [
{
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}