# Suna Health API

> SUNA is an AI-native wearable for gut health and nutrition — with intelligence across sleep, metabolism, cycle, and recovery. API for health scores, meals, sleep analysis, optimal timing, and more.

## Documentation
- [Suna 101](/docs/suna-101): What SUNA measures and how digestion scoring works
- [Quickstart](/docs/quickstart): Get started in 5 minutes with Python, TypeScript, or curl
- [Authentication](/docs/api/authentication): API keys, scopes, sandbox mode
- [Agent Guidelines](/docs/agents): MCP resources, recommended tool patterns, token efficiency

## Endpoints
- [Meals](/docs/api/nutrition/meals): Meal logging with macro/micro/food breakdown
- [Gut Scores](/docs/api/digestion/scores): Daily gut scores with component contributors
- [Overnight](/docs/api/digestion/overnight): Sleep-derived gut analysis
- [State](/docs/api/digestion/state): Current digestive state (fasted/processing/settling)
- [Timeline](/docs/api/digestion/timeline): Historical per-meal digestion phases
- [Windows](/docs/api/digestion/windows): Optimal meal, training, and sleep timing
- [Snapshot](/docs/api/snapshot): Composite endpoint — all data in one call
- [Webhooks](/docs/api/webhooks): Event subscriptions with HMAC-SHA256

## SDKs
- [Python](/docs/sdk/python): Python examples and patterns
- [TypeScript](/docs/sdk/typescript): TypeScript/Node examples

## Optional
- [Device Coverage](/docs/device-coverage): Which wearables support which data streams
- [Error Reference](/docs/api/errors): Error types with developer messages and agent suggestions
- [OpenAPI Spec](/api/v1/openapi.json): Machine-readable API contract (OpenAPI 3.1)