Snapshot (Composite)

GET /v1/snapshot

The agent-first endpoint. One call returns all data instead of 6+ sequential GETs.

Parameters

Param	Default	Description
`days`	7	1-90, number of days of data
`include`	all	Comma-separated: meals, scores, overnight, state, windows, insights, timeline

Example

curl "https://suna.health/api/v1/snapshot?days=7&include=meals,scores,state,windows" \
  -H "Authorization: Bearer suna_sk_live_xxx"

Response

{
  "object": "snapshot",
  "days": 7,
  "user": { "id": "..." },
  "nutrition": { "meals": [...] },
  "digestion": {
    "scores": { "daily": [...] },
    "state": { "state": "fasted", "active_meals": 0 },
    "windows": { "sleep_ready_at": "2026-03-17T22:30:00Z" }
  }
}

Use this instead of calling meals, scores, state, windows, and insights separately.