Skip to content

Get Chronic Insights

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

Chronic out-of-range insights (Track E): a metric sitting on the concerning side of an established guideline on most recent days — e.g. “your sodium has been above 2,300 mg on 27 of 30 days.” Catches persistently-unhealthy-but-stable values the change-detectors never see. Informational (guideline-based), deterministic, query-time; no LLM.

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

Successful Response

Media typeapplication/json
ChronicResponse
object
chronic
required
Chronic
Array<object>
ChronicCard

A chronic out-of-range insight — a metric persistently on the concerning side of an established guideline (Track E). See services/chronic_range.py.

object
breach_days
required
Breach Days
integer
breach_fraction
required
Breach Fraction
number
guideline
required
Guideline
string
headline
required
Headline
string
id
required
Id
string
key
required
Key
string
kind
required
Kind
string
label
required
Label
string
median
required
Median
number
ratio
required
Any of:
number
side
required
Side
string
threshold
required
Threshold
number
total_days
required
Total Days
integer
unit
required
Unit
string
window_days
required
Window Days
integer
Examplegenerated
{
"chronic": [
{
"breach_days": 1,
"breach_fraction": 1,
"guideline": "example",
"headline": "example",
"id": "example",
"key": "example",
"kind": "example",
"label": "example",
"median": 1,
"ratio": 1,
"side": "example",
"threshold": 1,
"total_days": 1,
"unit": "example"
}
],
"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"
}
]
}