Quickstart

Get Started in 5 Minutes

1. Get an API Key

Keys follow the format: suna_sk_live_xxxxxxxxxxxxxxxxxxxx (production) or suna_sk_test_xxxxxxxxxxxxxxxxxxxx (sandbox).

2. Make Your First Request

curl "https://suna.health/api/v1/snapshot?days=7" \
  -H "Authorization: Bearer suna_sk_live_your_key_here"

3. Understand the Response

{
  "object": "snapshot",
  "days": 7,
  "nutrition": { "meals": [...] },
  "digestion": {
    "scores": { "daily": [...] },
    "state": { "state": "fasted", "score_state": "SCORED" }
  },
  "request_id": "req_a1b2c3d4e5f6",
  "ts": "2026-03-17T12:00:00Z"
}

4. Check Score States