Digestion Scores

GET /v1/digestion/scores/daily

Daily gut scores with component breakdown. Scope: digestion:read

Response

{
  "object": "digestion.score",
  "date": "2026-03-16",
  "score": 78,
  "score_state": "SCORED",
  "level": "good",
  "components": {
    "overnight":    { "value": 0.82, "contribution": "positive" },
    "fasted_ratio": { "value": 0.71, "contribution": "neutral" },
    "regularity":   { "value": 0.85, "contribution": "positive" },
    "circadian":    { "value": 0.68, "contribution": "attention" }
  }
}

Score States

State	Meaning	Action
`SCORED`	Computed normally	Use the value
`PENDING`	Data still arriving	Retry later
`UNSCORABLE`	Insufficient data	Skip

Contributions

positive = helping your score, neutral = normal range, attention = pulling it down

Calibration

Responses include calibrating: true when the user has less than 2 days of data. Scores during calibration may be less reliable — show a notice in your UI or skip analysis.

GET /v1/digestion/scores/overnight

Sleep-derived gut analysis with feature contributions and deviation from baseline.