Attunio Clinical Intelligence API

Authorization: Bearer att_sk_live_a1b2c3d4e5f6...

// Runs in the browser — publishable keys are safe to ship to the client.
// The key only works from origins you allow-list in the dashboard.
const res = await fetch("https://attuniohealth.com/api/v1/dmse/analyze", {
  method: "POST",
  headers: {
    "Authorization": "Bearer att_pk_live_xxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    responseLatencySeconds: 2.6,
    speechRateWpm: 98,
    psychomotorFidgetEpisodes: 4,
    sustainedAttentionPct: 66,
  }),
})

const { data } = await res.json()

{
  "ok": false,
  "error": {
    "code": "forbidden",
    "message": "This origin is not allowed for this publishable key. Add it to the key's allowed origins in the developer dashboard."
  }
}

npm install @attunio/capture

import { AttunioSession, fromUserMedia } from '@attunio/capture'

// Publishable key — safe to ship in browser code.
const session = new AttunioSession({ publishableKey: 'att_pk_live_xxx' })

// Any WebRTC MediaStream works. Here: the patient's mic.
const stream = await fromUserMedia({ audio: true })
session.attach(stream)               // audio is processed on-device

// speech rate + response latency are extracted locally.
// Optionally merge in video-derived signals you already compute:
session.setVideoSignals({ psychomotorFidgetEpisodes: 4, sustainedAttentionPct: 72 })

const dmse = await session.analyze() // POSTs derived numbers, returns Digital MSE
session.stop()

// Each platform just resolves the MediaStream you already hold:
import {
  fromZoomTracks,    // Zoom Apps SDK media tracks
  fromDailyParticipant, // Daily local participant
  fromTwilioTracks,  // Twilio LocalAudioTrack / LocalVideoTrack
  fromVonagePublisher,  // Vonage / OpenTok publisher
  streamFromTracks,  // compose from raw MediaStreamTracks
} from '@attunio/capture'

session.attach(fromDailyParticipant(call.participants().local))

curl https://attuniohealth.com/api/v1/ping \
  -H "Authorization: Bearer att_sk_test_xxx"

curl https://attuniohealth.com/api/v1/dmse/analyze \
  -H "Authorization: Bearer att_sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "responseLatencySeconds": 2.6,
    "speechRateWpm": 98,
    "psychomotorFidgetEpisodes": 4,
    "sustainedAttentionPct": 66,
    "sessionDurationSeconds": 540,
    "history": {
      "response_latency": [3.1, 2.9, 2.7]
    },
    "sessionRef": "visit_8841"
  }'

{
  "ok": true,
  "data": {
    "object": "dmse.analysis",
    "sessionRef": "visit_8841",
    "generatedAt": "2026-06-28T15:04:05.000Z",
    "signalsPresent": 4,
    "overallConfidence": "high",
    "signals": [
      {
        "signalKey": "response_latency",
        "label": "Response latency",
        "present": true,
        "metricValue": 2.6,
        "metricUnit": "s",
        "interpretation": "clinical_attention",
        "detail": "Markedly delayed response latency (avg 2.6s).",
        "confidence": "high",
        "trendDir": "down",
        "mseLine": "Speech: increased response latency (avg ~2.6s).",
        "baseline": { "mean": 2.9, "sd": 0.2, "n": 3 }
      }
      // ... psychomotor, speech_rate, sustained_attention
    ],
    "mseNarrative": [
      "Speech: increased response latency (avg ~2.6s).",
      "Psychomotor: psychomotor agitation (4 fidget episodes during session)."
    ],
    "disclaimer": "Deterministic, rules-based decision support derived from numerical timing metrics. Not biometric ML, affect recognition, or an autonomous diagnosis. For clinician review only."
  }
}

curl https://attuniohealth.com/api/v1/medication/analyze \
  -H "Authorization: Bearer att_sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prescriptions": [
      {
        "id": "rx_001",
        "medicationName": "Sertraline",
        "dosage": "50mg",
        "frequency": "daily",
        "status": "active",
        "prescribedAt": "2026-03-01T00:00:00Z"
      }
    ],
    "assessments": [
      { "instrumentId": "phq9", "instrumentName": "PHQ-9", "score": 18, "maxScore": 27, "createdAt": "2026-02-20T00:00:00Z" },
      { "instrumentId": "phq9", "instrumentName": "PHQ-9", "score": 11, "maxScore": 27, "createdAt": "2026-05-15T00:00:00Z" }
    ],
    "dmseLatencyPctChange": -14
  }'

{
  "ok": true,
  "data": {
    "object": "medication.analysis",
    "generatedAt": "2026-06-28T15:04:05.000Z",
    "signalsPresent": 2,
    "signals": [
      {
        "module": "medication",
        "signalKey": "med_response_sertraline",
        "label": "Sertraline — symptom response",
        "detail": "PHQ-9 improved 18→11 (39% reduction) since Sertraline 50mg started.",
        "tone": "positive",
        "metricValue": 11,
        "metricUnit": "score",
        "confidence": "moderate",
        "summaryLine": "On Sertraline 50mg, PHQ-9 improved from 18 to 11 (39% reduction).",
        "sourceRef": "rx_001",
        "observedAt": "2026-05-15T00:00:00.000Z"
      }
      // ... objective Digital MSE™ corroboration signal
    ],
    "disclaimer": "..."
  }
}

curl https://attuniohealth.com/api/v1/biomarker/analyze \
  -H "Authorization: Bearer att_sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "labs": [
      {
        "id": "lab_88",
        "labName": "Quest Diagnostics",
        "observedAt": "2026-06-01T00:00:00Z",
        "results": {
          "biomarkers": [
            { "name": "TSH", "value": 6.8, "unit": "mIU/L", "flag": "high", "referenceRange": "0.4-4.0" },
            { "name": "Vitamin D", "value": 18, "unit": "ng/mL", "flag": "low", "referenceRange": "30-100" }
          ]
        }
      }
    ]
  }'

{
  "ok": true,
  "data": {
    "object": "biomarker.analysis",
    "generatedAt": "2026-06-28T15:04:05.000Z",
    "signalsPresent": 2,
    "signals": [
      {
        "module": "biomarker",
        "signalKey": "bio_tsh",
        "label": "Thyroid (TSH)",
        "detail": "6.8 mIU/L (ref 0.4-4.0) — elevated TSH can present as depression, fatigue, and cognitive slowing — screen before escalating an antidepressant.",
        "tone": "watch",
        "metricValue": 6.8,
        "metricUnit": "mIU/L",
        "confidence": "high",
        "summaryLine": "Thyroid (TSH) elevated at 6.8 mIU/L: ...",
        "sourceRef": "lab_88",
        "observedAt": "2026-06-01T00:00:00.000Z"
      }
      // ... vitamin D signal
    ],
    "disclaimer": "..."
  }
}

curl https://attuniohealth.com/api/v1/outcome/score \
  -H "Authorization: Bearer att_sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "assessments": [
      { "instrumentId": "phq9", "instrumentName": "PHQ-9", "score": 18, "maxScore": 27, "createdAt": "2026-02-20T00:00:00Z" },
      { "instrumentId": "phq9", "instrumentName": "PHQ-9", "score": 9, "maxScore": 27, "createdAt": "2026-05-15T00:00:00Z" }
    ],
    "dmseLatencyPctChange": -12,
    "activeMedications": 1,
    "biomarkerWatchCount": 0,
    "avgSleepHours": 7.5
  }'

{
  "ok": true,
  "data": {
    "object": "outcome.score",
    "generatedAt": "2026-06-28T15:04:05.000Z",
    "score": 66,
    "direction": "improving",
    "confidence": "high",
    "components": [
      { "key": "symptoms", "label": "Symptom scales", "contribution": 45, "detail": "PHQ-9 improved 18→9 across 2 administrations.", "available": true },
      { "key": "dmse", "label": "Digital MSE™ latency", "contribution": 6, "detail": "Response latency changed -12% across visits.", "available": true }
      // ... medication, biomarker, sleep components
    ],
    "summaryLine": "Treatment response is improving (composite +66) across 4 independent data sources.",
    "sourceCount": 4,
    "disclaimer": "..."
  }
}

curl https://attuniohealth.com/api/v1/relapse/predict \
  -H "Authorization: Bearer att_sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "assessments": [
      { "instrumentId": "phq9", "instrumentName": "PHQ-9", "score": 12, "maxScore": 27, "createdAt": "2026-05-01T00:00:00Z" },
      { "instrumentId": "phq9", "instrumentName": "PHQ-9", "score": 19, "maxScore": 27, "severity": "moderately severe", "createdAt": "2026-06-15T00:00:00Z" }
    ],
    "dmseLatencyPctChange": 16,
    "avgSleepHours": 5.2,
    "daysSinceMedChange": 12,
    "hasActiveMedication": true,
    "daysSinceLastVisit": 38
  }'

{
  "ok": true,
  "data": {
    "object": "relapse.prediction",
    "generatedAt": "2026-06-28T15:04:05.000Z",
    "score": 68,
    "level": "elevated",
    "trend": "rising",
    "confidence": "high",
    "topDriver": "Symptom trajectory",
    "factors": [
      { "key": "symptoms", "label": "Symptom trajectory", "points": 34.4, "maxPoints": 38, "tone": "elevated", "available": true, "detail": "PHQ-9 rising 12→19/27 (moderately severe) at the two most recent administrations." },
      { "key": "sleep", "label": "Sleep (wearable)", "points": 12, "maxPoints": 18, "tone": "elevated", "available": true, "detail": "Averaging 5.2h/night recently — short sleep is a leading relapse precursor." }
      // ... dmse, medication, cadence factors
    ],
    "summaryLine": "Elevated relapse risk (68/100), signals rising, driven primarily by symptom trajectory.",
    "recommendation": "Flag for closer monitoring; consider a check-in before the next scheduled visit.",
    "sourceCount": 5,
    "disclaimer": "..."
  }
}

{
  "ok": true,
  "data": {
    "object": "relapse.prediction",
    "model": {
      "key": "relapse_risk",
      "version": 4,          // null until a calibrated version is promoted
      "source": "calibrated" // "default" = shipped constants, "calibrated" = clinician-promoted
    },
    "score": 68,
    "level": "elevated"
    // ... factors, recommendation, disclaimer
  }
}

{
  "ok": false,
  "error": {
    "code": "invalid_request",
    "message": "Telemetry validation failed.",
    "issues": [
      { "path": "responseLatencySeconds", "message": "Number must be ≤ 120" }
    ]
  }
}