Suna Health API
SUNA is an AI-native wearable for gut health and nutrition — with intelligence across sleep, metabolism, cycle, and recovery. Agent-first API design.
Suna 101
6 health domains: gut, sleep, metabolism, cycle, recovery, activity
Quickstart
Make your first API call in 5 minutes
Snapshot Endpoint
All data in one call — designed for AI agents
Estimates Evidence
Proprietary derived biomarker estimates
Core Endpoints
| Endpoint | Description | Status |
|---|---|---|
GET /v1/user/me | User profile + connected devices | Live |
GET /v1/nutrition/meals | Meal logs with macro/micro/food breakdown | Live |
GET /v1/digestion/scores/daily | Daily gut scores with component contributors | Live |
GET /v1/digestion/scores/overnight | Sleep-derived gut analysis | Live |
GET /v1/digestion/state | Current digestive state (fasted/processing/settling) | Live |
GET /v1/digestion/timeline | Historical per-meal digestion phases | Live |
GET /v1/digestion/windows | Optimal meal/training/sleep timing | Live |
GET /v1/snapshot | Composite — all data in one call | Live |
GET /v1/physio/* | Physiological data streams | Planned |
GET /v1/acoustic/* | Proprietary acoustic analysis | Planned |
GET /v1/estimates/* | Derived biomarker estimates | Planned |
GET /v1/intelligence/* | Advanced computed analytics | Planned |
For AI Agents
Suna is designed for agent consumption from day one:
/v1/snapshot— all data in one call instead of 6+ sequential GETssuggestionfield in every error — machine-actionable fix instructions/llms.txt— agent discovery file at suna.health/llms.txt- OpenAPI 3.1 — machine-readable spec at /api/v1/openapi.json
- MCP Server — planned for direct LLM integration