API reference

Every endpoint, from the contract.

Rendered from the OpenAPI 3.1 document at /v1/openapi.json, which is generated from the same schemas that validate requests. Base URL: https://www.medera.info/api/v1.

GET/v1

API index

Version, engine and the list of endpoints.

No key needed200: ApiIndex
Example
curl -s https://www.medera.info/api/v1

GET/v1/health

Health

Liveness of the service. No authentication.

No key needed200: Health
Example
curl -s https://www.medera.info/api/v1/health

GET/v1/openapi.json

OpenAPI document

This contract, as OpenAPI 3.1.

No key needed200: OpenApiDocument
Example
curl -s https://www.medera.info/api/v1/openapi.json

GET/v1/samples/{kind}

Download a sample request

A synthetic, deterministic request body for an analyze endpoint, so a first request needs nothing but curl: vocal (a six-second WAV file), physiological, facial, clinical-context, inference or analyze (JSON). No real person's data. No authentication.

No key needed200: SampleRequest
ParameterInNotes
kindrequiredpathWhich endpoint the sample is for. One of: vocal, physiological, facial, clinical-context, inference, analyze.
Example
curl -s https://www.medera.info/api/v1/samples/physiological -o physiological.json
curl -s https://www.medera.info/api/v1/samples/vocal -o speech.wav

GET/v1/biomarkers

List biomarkers

Every measured biomarker with its unit, definition, method, quality gate, published associations, RDoC domain and references. Filter with ?modality=vocal|physiological|facial|clinical.

No key needed200: BiomarkerList
ParameterInNotes
modalityqueryOne of: vocal, physiological, facial, clinical.
Example
curl -s "https://www.medera.info/api/v1/biomarkers?modality=physiological"

GET/v1/biomarkers/{key}

Retrieve a biomarker

One catalog entry by key, for example f0SdSemitones.

No key needed200: Biomarker
ParameterInNotes
keyrequiredpathBiomarker key.
Example
curl -s https://www.medera.info/api/v1/biomarkers/f0SdSemitones

POST/v1/vocal/analyze

Analyze voice

Measures the vocal panel from a WAV recording: pitch, voice quality, spectrum, articulation and timing for each channel, plus word rates and language markers when a transcript is attached. Send multipart/form-data with an audio part (and an optional options part holding JSON), or a raw audio/wav body with channel_roles and language as query parameters.

Bearer key requiredmultipart/form-dataaudio/wav200: VocalAnalysis
ParameterInNotes
channel_rolesqueryFor audio/wav bodies: comma-separated labels.
languagequeryOne of: en, ar.

Request body (multipart/form-data)

FieldTypeNotes
audiorequiredfile (audio/wav)PCM or IEEE-float WAV, 8–192 kHz, 1–8 channels.
optionsobjectJSON text.
options.channel_rolesarray of stringA label per channel, for example ["clinician", "patient"]. Channels are treated as separated speakers. Constraints: at most 8 items.
options.language"en" | "ar"Transcript language: English or Arabic.
options.transcriptsarray of objectOptional transcripts. They unlock speaking and articulation rate and the language markers. Constraints: at most 8 items.
options.transcripts[].channelintegerChannel the transcript belongs to. Constraints: ≥ 0, ≤ 7.
options.transcripts[].textrequiredstringVerbatim transcript; keep fillers for disfluency markers. Constraints: at least 1 character, at most 100000 characters.
options.transcripts[].language"en" | "ar"Transcript language: English or Arabic.
options.subject_channelintegerFor /v1/analyze: which channel is the person being measured. Defaults to the channel labeled patient, else 0. Constraints: ≥ 0, ≤ 7.
# A six-second synthetic speech sample
curl -s https://www.medera.info/api/v1/samples/vocal -o speech.wav

curl -s https://www.medera.info/api/v1/vocal/analyze \
  -H "Authorization: Bearer mk_sandbox_medera_public" \
  -F audio=@speech.wav \
  -F 'options={"language":"en"}'
POST/v1/vocal/analyze
Sample request

Sends the synthetic sample to the live sandbox with the public key and shows the full response. Nothing personal is sent and nothing is stored.

Response for the published sample · 200
{
  "object": "vocal.analysis",
  "api_version": "v1",
  "mode": "sandbox",
  "engine": {
    "name": "medera-inference",
    "version": "1.0.0",
    "vocal": "BH-ASR voice layer 1.2.0 (TypeScript port, number-for-number with the Python reference)"
  },
  "intended_use": "Measured biomarkers and within-person change for research and clinician review. Not a diagnosis and not a medical device.",
  "input": {
    "sample_rate_hz": 16000,
    "channels": 1,
    "duration_s": 6,
    "bits_per_sample": 16,
    "encoding": "pcm"
  },
  "separation": "none",
  "speakers": [
    {
      "label": "speaker",
      "channel": 0,
      "biomarkers": {
        "f0MeanSemitone": 28.58,
        "f0MedianHz": 144,
        "f0SdSemitones": 1.778,
        "f0Range20_80Semitones": 2.807,
        "jitterLocalPct": 0.859,
        "shimmerLocalPct": 8.871,
        "shimmerLocalDb": 0.827,
        "hnrDb": 14.98,
        "cppsDb": 14.3,
        "f1MedianHz": 601.9,
        "f2MedianHz": 1107.4,
        "f3MedianHz": 2361.9,
        "f1BandwidthHz": 86.3,
        "f2BandwidthHz": 89.3,
        "f3BandwidthHz": 227.4,
        "f2RobustSdHz": 678.9,
        "alphaRatioDb": -11.174,
        "hammarbergIndexDb": 28.013,
        "spectralSlope0_500DbPerKHz": 20.852,
        "spectralSlope500_1500DbPerKHz": -22.317,
        "h1h2Db": -3.729,
        "h1a3Db": 10.301,
        "spectralFluxMean": 0.04596,
        "intensityMeanDb": -25.72,
        "intensitySdDb": 8.5,
        "loudnessPeaksPerSec": 5.682,
        "voicedFraction": 0.943,
        "voicedSegmentsPerSec": 4.261,
        "meanVoicedSegmentS": 0.221,
        "meanUnvoicedSegmentS": 0.149,
        "pauseCount": 2,
        "pauseRatio": 0.1981,
        "meanPauseS": 0.535,
        "longestPauseS": 0.59,
        "speakingRateWpm": null,
        "articulationRateWpm": null,
        "responseLatencyS": null,
        "words": null,
        "firstPersonSingularPer100": null,
        "absolutistPer100": null,
        "negativeAffectPer100": null,
        "fillerPer100": null,
        "repetitionPer100": null
      },
      "mfcc": {
        "mean": [
          79.386,
          -7.795,
          -9.465,
          -5.513
        ],
        "sd": [
          21.647,
          12.619,
          20.791,
          12.251
        ]
      },
      "quality": {
        "duration_s": 6,
        "speech_s": 3.52,
        "voiced_s": 3.32,
        "periods": 449,
        "snr_db": 41.3,
        "clipped_fraction": 0,
        "flags": [
          "speakers_not_separated",
          "rates_and_language_require_transcript",
          "latency_requires_separate_channels"
        ]
      }
    }
  ]
}
Computed by the engine. Each call also carries an id and a created timestamp.

POST/v1/physiological/analyze

Analyze physiological signals

Heart rate variability from RR intervals or PPG, electrodermal activity, sleep and the rest-activity rhythm. Every signal is optional.

Bearer key requiredapplication/json200: PhysiologicalAnalysis

Request body (JSON)

FieldTypeNotes
heartobject
heart.rr_msarray of numberRR or inter-beat intervals in milliseconds, in order. Constraints: at least 2 items.
heart.ppgobjectRaw photoplethysmogram; systolic peaks are detected server-side (Elgendi 2013).
heart.ppg.sample_rate_hzrequirednumberConstraints: ≥ 20, ≤ 1000.
heart.ppg.samplesrequiredarray of numberConstraints: at least 1 item.
edaobject
eda.sample_rate_hzrequirednumberConstraints: ≥ 1, ≤ 1000.
eda.samples_usrequiredarray of numberSkin conductance in microsiemens. Constraints: at least 1 item.
eda.scr_min_amplitude_usnumberSCR amplitude criterion, 0.01 to 0.05 µS (default 0.05). Constraints: ≥ 0.01, ≤ 0.05.
sleepobject
sleep.nightsrequiredarray of objectConstraints: at most 400 items.
sleep.nights[].sleep_onsetrequiredstring (date-time)ISO 8601 date-time with a UTC offset.
sleep.nights[].wake_timerequiredstring (date-time)ISO 8601 date-time with a UTC offset.
sleep.nights[].total_sleep_minutesnumberConstraints: ≥ 0, ≤ 1440.
sleep.nights[].time_in_bed_minutesnumberConstraints: ≥ 0, ≤ 1440.
sleep.nights[].sleep_onset_latency_minutesnumberConstraints: ≥ 0, ≤ 600.
sleep.nights[].sleep_efficiency_pctnumberConstraints: ≥ 0, ≤ 100.
sleep.epochsobjectSleep/wake epochs for the Sleep Regularity Index.
sleep.epochs.startrequiredstring (date-time)ISO 8601 date-time with a UTC offset.
sleep.epochs.epoch_secondsrequired30 | 60
sleep.epochs.statesrequiredarray of 0 | 11 = asleep, 0 = awake, one value per epoch.
activityobject
activity.hourly_countsarray of numberHourly activity counts, starting at the top of an hour. Constraints: ≥ 0.
activity.daily_stepsarray of numberConstraints: ≥ 0.
# The published sample request (synthetic, no real person's data)
curl -s https://www.medera.info/api/v1/samples/physiological -o physiological.json

curl -s https://www.medera.info/api/v1/physiological/analyze \
  -H "Authorization: Bearer mk_sandbox_medera_public" \
  -H "Content-Type: application/json" \
  --data @physiological.json
POST/v1/physiological/analyze
Sample request

Sends the synthetic sample to the live sandbox with the public key and shows the full response. Nothing personal is sent and nothing is stored.

Response for the published sample · 200
{
  "object": "physiological.analysis",
  "api_version": "v1",
  "mode": "sandbox",
  "engine": {
    "name": "medera-inference",
    "version": "1.0.0",
    "vocal": "BH-ASR voice layer 1.2.0 (TypeScript port, number-for-number with the Python reference)"
  },
  "intended_use": "Measured biomarkers and within-person change for research and clinician review. Not a diagnosis and not a medical device.",
  "biomarkers": {
    "meanHrBpm": 69.8,
    "meanNnMs": 859.6,
    "sdnnMs": 30.47,
    "rmssdMs": 34.15,
    "sdsdMs": 34.2,
    "pnn50Pct": 13.14,
    "sd1Ms": 24.18,
    "sd2Ms": 35.66,
    "vlfPowerMs2": 4.8,
    "lfPowerMs2": 253.7,
    "hfPowerMs2": 641,
    "lfHfRatio": 0.396,
    "lfNu": 28.4,
    "hfNu": 71.6,
    "sclMeanUs": null,
    "scrPerMin": null,
    "scrAmplitudeMeanUs": null,
    "totalSleepTimeH": 7.44,
    "sleepEfficiencyPct": 89.3,
    "sleepOnsetLatencyMin": 20.1,
    "sleepMidpointSdMin": 20.5,
    "totalSleepTimeSdMin": 16.6,
    "sleepRegularityIndex": null,
    "activityMeanCountsPerHour": 736.36,
    "dailyStepsMean": 6799,
    "m10": 1350.64,
    "l5": 39.6,
    "relativeAmplitude": 0.943,
    "interdailyStability": 0.982,
    "intradailyVariability": 0.267
  },
  "quality": {
    "heart": {
      "beats": 350,
      "normal_fraction": 1,
      "duration_s": 300.9,
      "flags": [],
      "source": "rr"
    },
    "eda": null,
    "sleep": {
      "nights": 7,
      "flags": []
    },
    "activity": {
      "days": 7,
      "flags": []
    }
  }
}
Computed by the engine. Each call also carries an id and a created timestamp.

POST/v1/facial/analyze

Analyze facial behavior

Expression, gaze, blink and head-motion biomarkers from per-frame MediaPipe Face Landmarker blendshapes computed on the device. No image is sent or stored.

Bearer key requiredapplication/json200: FacialAnalysis

Request body (JSON)

FieldTypeNotes
fpsrequirednumberFrames per second of the landmarker output. Constraints: ≥ 1, ≤ 120.
framesrequiredarray of null | objectConstraints: at least 1 item.
# The published sample request (synthetic, no real person's data)
curl -s https://www.medera.info/api/v1/samples/facial -o facial.json

curl -s https://www.medera.info/api/v1/facial/analyze \
  -H "Authorization: Bearer mk_sandbox_medera_public" \
  -H "Content-Type: application/json" \
  --data @facial.json
POST/v1/facial/analyze
Sample request

Sends the synthetic sample to the live sandbox with the public key and shows the full response. Nothing personal is sent and nothing is stored.

Response for the published sample · 200
{
  "object": "facial.analysis",
  "api_version": "v1",
  "mode": "sandbox",
  "engine": {
    "name": "medera-inference",
    "version": "1.0.0",
    "vocal": "BH-ASR voice layer 1.2.0 (TypeScript port, number-for-number with the Python reference)"
  },
  "intended_use": "Measured biomarkers and within-person change for research and clinician review. Not a diagnosis and not a medical device.",
  "biomarkers": {
    "smileIntensityMean": 0.2025,
    "smileFrequencyPerMin": 8,
    "duchenneSmileFraction": 1,
    "browLoweringMean": 0.1053,
    "lipCornerDepressorMean": 0.0346,
    "dimplerMean": 0.0352,
    "expressivityMean": 0.0532,
    "expressivityVariability": 0.0264,
    "blinkRatePerMin": 18,
    "downwardGazeFraction": 0.1822,
    "gazeAversionFraction": 0.1822,
    "headMotionDegPerSec": 1.576,
    "headPitchSdDeg": 1.332,
    "headYawSdDeg": 2.838
  },
  "quality": {
    "frames": 450,
    "face_frames": 450,
    "face_s": 30,
    "pose_frames": 450,
    "flags": []
  }
}
Computed by the engine. Each call also carries an id and a created timestamp.

POST/v1/clinical-context/analyze

Analyze clinical context

Scores PHQ-9, GAD-7, PCL-5, MDQ and the C-SSRS screener with their published rules, measures language markers from a transcript, checks ICD-10-CM codes, and returns a safety block that routes risk items to a clinician.

Bearer key requiredapplication/json200: ClinicalContextAnalysis

Request body (JSON)

FieldTypeNotes
instrumentsobject
instruments.phq9objectPHQ-9: nine items scored 0–3, in order; optional difficulty item.
instruments.phq9.itemsrequiredarray of integerConstraints: at least 9 items, at most 9 items.
instruments.phq9.difficultyintegerConstraints: ≥ 0, ≤ 3.
instruments.gad7objectGAD-7: seven items scored 0–3.
instruments.gad7.itemsrequiredarray of integerConstraints: at least 7 items, at most 7 items.
instruments.pcl5objectPCL-5: twenty items scored 0–4.
instruments.pcl5.itemsrequiredarray of integerConstraints: at least 20 items, at most 20 items.
instruments.mdqobjectMood Disorder Questionnaire: 13 yes/no items, question 2 and question 3.
instruments.mdq.itemsrequiredarray of booleanConstraints: at least 13 items, at most 13 items.
instruments.mdq.same_periodrequiredboolean
instruments.mdq.problemrequired"none" | "minor" | "moderate" | "serious"
instruments.cssrsobjectC-SSRS screener answers (questions 1–5 for the past month or since last contact; question 6 behavior).
instruments.cssrs.versionrequired"lifetime_recent" | "since_last_contact"
instruments.cssrs.wish_deadrequiredboolean
instruments.cssrs.thoughtsrequiredboolean
instruments.cssrs.methodboolean
instruments.cssrs.intentboolean
instruments.cssrs.planboolean
instruments.cssrs.behaviorrequiredboolean
instruments.cssrs.behavior_within_3_monthsboolean
transcriptobjectWhat the person said, for the language markers.
transcript.textrequiredstringConstraints: at least 1 character, at most 200000 characters.
transcript.language"en" | "ar"Transcript language: English or Arabic.
diagnosesarray of stringICD-10-CM codes from the record. Constraints: at most 50 items.
# The published sample request (synthetic, no real person's data)
curl -s https://www.medera.info/api/v1/samples/clinical-context -o clinical-context.json

curl -s https://www.medera.info/api/v1/clinical-context/analyze \
  -H "Authorization: Bearer mk_sandbox_medera_public" \
  -H "Content-Type: application/json" \
  --data @clinical-context.json
POST/v1/clinical-context/analyze
Sample request

Sends the synthetic sample to the live sandbox with the public key and shows the full response. Nothing personal is sent and nothing is stored.

Response for the published sample · 200
{
  "object": "clinical_context.analysis",
  "api_version": "v1",
  "mode": "sandbox",
  "engine": {
    "name": "medera-inference",
    "version": "1.0.0",
    "vocal": "BH-ASR voice layer 1.2.0 (TypeScript port, number-for-number with the Python reference)"
  },
  "intended_use": "Measured biomarkers and within-person change for research and clinician review. Not a diagnosis and not a medical device.",
  "instruments": {
    "phq9": {
      "instrument": "phq9",
      "total": 13,
      "band": "moderate",
      "band_range": "10–14",
      "item9": 0,
      "item9_positive": false,
      "difficulty": 2
    },
    "gad7": {
      "instrument": "gad7",
      "total": 9,
      "band": "mild",
      "band_range": "5–9"
    },
    "pcl5": null,
    "mdq": null,
    "cssrs": null
  },
  "language": {
    "words": 57,
    "firstPersonSingularPer100": 15.789,
    "absolutistPer100": 3.509,
    "negativeAffectPer100": 3.509,
    "fillerPer100": 1.754,
    "repetitionPer100": 0,
    "counts": {
      "first_person_singular": 9,
      "absolutist": 2,
      "negative_affect": 2,
      "filler": 1,
      "repetition": 0
    },
    "language": "en"
  },
  "biomarkers": {
    "words": 57,
    "firstPersonSingularPer100": 15.789,
    "absolutistPer100": 3.509,
    "negativeAffectPer100": 3.509,
    "fillerPer100": 1.754,
    "repetitionPer100": 0
  },
  "diagnoses": [
    {
      "code": "F32.1",
      "valid_format": true,
      "chapter5_block": "F30-F39",
      "block_title": "Mood [affective] disorders"
    }
  ],
  "safety": {
    "review_required": false,
    "priority": "routine",
    "reasons": []
  }
}
Computed by the engine. Each call also carries an id and a created timestamp.

POST/v1/inference

Run inference

Compares a session with the same person's baseline per RDoC domain (conformal or parametric p-values, stable / watch / review tiers) and computes condition probabilities from validated instruments with setting priors.

Bearer key requiredapplication/json200: Inference

Request body (JSON)

FieldTypeNotes
currentrequiredobject
current.biomarkersrequiredobjectBiomarker key → value, as returned by the analyze endpoints.
baselineobject
baseline.sessionsarray of objectEarlier sessions of the same person. 19 or more enable conformal p-values at alpha 0.05.
baseline.sessions[].biomarkersrequiredobjectBiomarker key → value, as returned by the analyze endpoints.
baseline.sessions[].captured_atstring (date-time)ISO 8601 date-time with a UTC offset.
baseline.statsobjectAlternatively, per-biomarker baseline mean, standard deviation and count.
instrumentsobject
instruments.phq9objectPHQ-9: nine items scored 0–3, in order; optional difficulty item.
instruments.phq9.itemsrequiredarray of integerConstraints: at least 9 items, at most 9 items.
instruments.phq9.difficultyintegerConstraints: ≥ 0, ≤ 3.
instruments.gad7objectGAD-7: seven items scored 0–3.
instruments.gad7.itemsrequiredarray of integerConstraints: at least 7 items, at most 7 items.
instruments.pcl5objectPCL-5: twenty items scored 0–4.
instruments.pcl5.itemsrequiredarray of integerConstraints: at least 20 items, at most 20 items.
instruments.mdqobjectMood Disorder Questionnaire: 13 yes/no items, question 2 and question 3.
instruments.mdq.itemsrequiredarray of booleanConstraints: at least 13 items, at most 13 items.
instruments.mdq.same_periodrequiredboolean
instruments.mdq.problemrequired"none" | "minor" | "moderate" | "serious"
instruments.cssrsobjectC-SSRS screener answers (questions 1–5 for the past month or since last contact; question 6 behavior).
instruments.cssrs.versionrequired"lifetime_recent" | "since_last_contact"
instruments.cssrs.wish_deadrequiredboolean
instruments.cssrs.thoughtsrequiredboolean
instruments.cssrs.methodboolean
instruments.cssrs.intentboolean
instruments.cssrs.planboolean
instruments.cssrs.behaviorrequiredboolean
instruments.cssrs.behavior_within_3_monthsboolean
contextobject
context.setting"primary_care" | "specialty_outpatient" | "mental_health" | "general_population" | "veterans"Care setting; selects the prevalence prior and setting-specific likelihood ratios.
context.pretest_probabilityobjectYour own pre-test probabilities; they override the setting priors.
optionsobject
options.alpha_watchnumberConstraints: > 0, ≤ 0.2.
options.alpha_reviewnumberConstraints: > 0, ≤ 0.1.
options.rho_within_modalitynumberConstraints: ≥ 0, ≤ 0.95.
options.rho_across_modalitiesnumberConstraints: ≥ 0, ≤ 0.95.
options.rho_same_conditionnumberConstraints: ≥ 0, ≤ 0.95.
options.min_baselineintegerConstraints: ≥ 3, ≤ 100.
# The published sample request (synthetic, no real person's data)
curl -s https://www.medera.info/api/v1/samples/inference -o inference.json

curl -s https://www.medera.info/api/v1/inference \
  -H "Authorization: Bearer mk_sandbox_medera_public" \
  -H "Content-Type: application/json" \
  --data @inference.json
POST/v1/inference
Sample request

Sends the synthetic sample to the live sandbox with the public key and shows the full response. Nothing personal is sent and nothing is stored.

Response for the published sample · 200
{
  "object": "inference",
  "api_version": "v1",
  "mode": "sandbox",
  "engine": {
    "name": "medera-inference",
    "version": "1.0.0",
    "vocal": "BH-ASR voice layer 1.2.0 (TypeScript port, number-for-number with the Python reference)"
  },
  "intended_use": "Measured biomarkers and within-person change for research and clinician review. Not a diagnosis and not a medical device.",
  "tier": "review",
  "change": {
    "status": "computed",
    "method": "conformal",
    "baseline_sessions": 24,
    "alpha": {
      "watch": 0.05,
      "review": 0.01
    },
    "guarantee": "Watch: under exchangeability of the baseline sessions and this session (no real change), a domain is flagged with probability at most alpha_watch, with no distributional assumption when p-values are conformal; Benjamini–Hochberg across domains controls the false discovery rate. Review: the domain must also exceed alpha_review under the normal prediction model.",
    "notes": [],
    "biomarkers": [
      {
        "key": "speakingRateWpm",
        "name": "Speaking rate",
        "modality": "vocal",
        "value": 128,
        "baseline": {
          "mean": 153.8028,
          "sd": 8.463,
          "n": 24
        },
        "z": -2.987,
        "domain": "sensorimotor",
        "concern": "down",
        "concern_z": 2.987
      },
      {
        "key": "pauseRatio",
        "name": "Pause ratio",
        "modality": "vocal",
        "value": 0.29,
        "baseline": {
          "mean": 0.2029,
          "sd": 0.0266,
          "n": 24
        },
        "z": 3.213,
        "domain": "sensorimotor",
        "concern": "up",
        "concern_z": 3.213
      },
      {
        "key": "meanPauseS",
        "name": "Mean pause",
        "modality": "vocal",
        "value": 0.84,
        "baseline": {
          "mean": 0.6336,
          "sd": 0.0692,
          "n": 24
        },
        "z": 2.92,
        "domain": "sensorimotor",
        "concern": "up",
        "concern_z": 2.92
      },
      {
        "key": "f0SdSemitones",
        "name": "Pitch variability",
        "modality": "vocal",
        "value": 2.2,
        "baseline": {
          "mean": 3.1118,
          "sd": 0.2955,
          "n": 24
        },
        "z": -3.023,
        "domain": "positive_valence",
        "concern": "down",
        "concern_z": 3.023
      },
      {
        "key": "firstPersonSingularPer100",
        "name": "First-person singular",
        "modality": "clinical",
        "value": 9.1,
        "baseline": {
          "mean": 6.6013,
          "sd": 1.3289,
          "n": 24
        },
        "z": 1.842,
        "domain": "social",
        "concern": "up",
        "concern_z": 1.842
      },
      {
        "key": "rmssdMs",
        "name": "RMSSD",
        "modality": "physiological",
        "value": 31,
        "baseline": {
          "mean": 43.8116,
          "sd": 4.5905,
          "n": 24
        },
        "z": -2.734,
        "domain": "arousal_regulatory",
        "concern": "down",
        "concern_z": 2.734
      },
      {
        "key": "meanHrBpm",
        "name": "Mean heart rate",
        "modality": "physiological",
        "value": 74,
        "baseline": {
          "mean": 66.122,
          "sd": 2.6602,
          "n": 24
        },
        "z": 2.902,
        "domain": "arousal_regulatory",
        "concern": "up",
        "concern_z": 2.902
      },
      {
        "key": "sleepEfficiencyPct",
        "name": "Sleep efficiency",
        "modality": "physiological",
        "value": 82,
        "baseline": {
          "mean": 89.1211,
          "sd": 2.5576,
          "n": 24
        },
        "z": -2.728,
        "domain": "arousal_regulatory",
        "concern": "down",
        "concern_z": 2.728
      },
      {
        "key": "smileIntensityMean",
        "name": "Smile intensity",
        "modality": "facial",
        "value": 0.19,
        "baseline": {
          "mean": 0.2787,
          "sd": 0.0454,
          "n": 24
        },
        "z": -1.912,
        "domain": "positive_valence",
        "concern": "down",
        "concern_z": 1.912
      },
      {
        "key": "expressivityMean",
        "name": "Facial expressivity",
        "modality": "facial",
        "value": 0.07,
        "baseline": {
          "mean": 0.0888,
          "sd": 0.0089,
          "n": 24
        },
        "z": -2.069,
        "domain": "positive_valence",
        "concern": "down",
        "concern_z": 2.069
      },
      {
        "key": "gazeAversionFraction",
        "name": "Gaze aversion",
        "modality": "facial",
        "value": 0.27,
        "baseline": {
          "mean": 0.1824,
          "sd": 0.0412,
          "n": 24
        },
        "z": 2.083,
        "domain": "social",
        "concern": "up",
        "concern_z": 2.083
      },
      {
        "key": "headMotionDegPerSec",
        "name": "Head motion",
        "modality": "facial",
        "value": 4.4,
        "baseline": {
          "mean": 6.0537,
          "sd": 1.3778,
          "n": 24
        },
        "z": -1.176,
        "domain": "sensorimotor",
        "concern": "down",
        "concern_z": 1.176
      }
    ],
    "domains": [
      {
        "domain": "sensorimotor",
        "label": "Sensorimotor systems",
        "biomarkers": 4,
        "effective_biomarkers": 2.5,
        "score": 4.07,
        "p_value": 0.04,
        "p_conformal": 0.04,
        "p_parametric": 0,
        "q_value": 0.04,
        "tier": "review",
        "contributors": [
          {
            "key": "pauseRatio",
            "concern_z": 3.213,
            "weight": 1
          },
          {
            "key": "speakingRateWpm",
            "concern_z": 2.987,
            "weight": 1
          },
          {
            "key": "meanPauseS",
            "concern_z": 2.92,
            "weight": 1
          },
          {
            "key": "headMotionDegPerSec",
            "concern_z": 1.176,
            "weight": 1
          }
        ]
      },
      {
        "domain": "arousal_regulatory",
        "label": "Arousal and regulatory systems",
        "biomarkers": 3,
        "effective_biomarkers": 1.88,
        "score": 3.818,
        "p_value": 0.04,
        "p_conformal": 0.04,
        "p_parametric": 0.0001,
        "q_value": 0.04,
        "tier": "review",
        "contributors": [
          {
            "key": "meanHrBpm",
            "concern_z": 2.902,
            "weight": 1
          },
          {
            "key": "rmssdMs",
            "concern_z": 2.734,
            "weight": 1
          },
          {
            "key": "sleepEfficiencyPct",
            "concern_z": 2.728,
            "weight": 1
          }
        ]
      },
      {
        "domain": "positive_valence",
        "label": "Positive valence systems",
        "biomarkers": 3,
        "effective_biomarkers": 2.25,
        "score": 3.502,
        "p_value": 0.04,
        "p_conformal": 0.04,
        "p_parametric": 0.0002,
        "q_value": 0.04,
        "tier": "review",
        "contributors": [
          {
            "key": "f0SdSemitones",
            "concern_z": 3.023,
            "weight": 1
          },
          {
            "key": "expressivityMean",
            "concern_z": 2.069,
            "weight": 1
          },
          {
            "key": "smileIntensityMean",
            "concern_z": 1.912,
            "weight": 1
          }
        ]
      },
      {
        "domain": "social",
        "label": "Social processes",
        "biomarkers": 2,
        "effective_biomarkers": 1.82,
        "score": 2.646,
        "p_value": 0.04,
        "p_conformal": 0.04,
        "p_parametric": 0.0041,
        "q_value": 0.04,
        "tier": "review",
        "contributors": [
          {
            "key": "gazeAversionFraction",
            "concern_z": 2.083,
            "weight": 1
          },
          {
            "key": "firstPersonSingularPer100",
            "concern_z": 1.842,
            "weight": 1
          }
        ]
      }
    ],
    "overall": {
      "score": 19.83,
      "p_value": 0.04,
      "p_conformal": 0.04,
      "p_parametric": 0,
      "tier": "review",
      "biomarkers": 12
    }
  },
  "conditions": [
    {
      "condition": "mdd",
      "label": "Major depression",
      "status": "computed",
      "prior": {
        "value": 0.1192,
        "source": "Levis 2019, primary care: 377 of 3,163 (11.9%)."
      },
      "evidence": [
        {
          "source": "instrument",
          "name": "PHQ-9",
          "observation": "total 13 (band 10–14)",
          "likelihood_ratio": 2.9091,
          "derivation": "(0.88 − 0.56) / (0.96 − 0.85)",
          "imprecise": false
        }
      ],
      "combined_likelihood_ratio": 2.9091,
      "probability": 0.2825,
      "references": [
        "Levis2019"
      ],
      "caveats": [
        "Interval likelihood ratios are derived from pooled sensitivity and specificity at cutoffs 5, 10 and 15; they are point estimates without confidence intervals.",
        "Levis 2019 excluded youth and psychiatric settings; supply your own pre-test probability there."
      ]
    },
    {
      "condition": "gad",
      "label": "Generalized anxiety disorder",
      "status": "no_evidence",
      "prior": {
        "value": 0.0756,
        "source": "Spitzer 2006, primary care: 73 of 965 interviewed (7.6%)."
      },
      "evidence": [],
      "combined_likelihood_ratio": null,
      "probability": null,
      "references": [
        "Akturk2025"
      ],
      "caveats": [
        "Pooled estimates are heterogeneous across settings; the review calls them rough averages.",
        "The GAD-7 is used here as a screen for GAD, not for any anxiety disorder."
      ]
    },
    {
      "condition": "ptsd",
      "label": "Post-traumatic stress disorder",
      "status": "no_evidence",
      "prior": null,
      "evidence": [],
      "combined_likelihood_ratio": null,
      "probability": null,
      "references": [
        "Bovin2016",
        "NCPTSD_PCL5"
      ],
      "caveats": [
        "Validated in a high-prevalence veteran sample; in other settings supply a pre-test probability.",
        "No peer-reviewed diagnostic-accuracy meta-analysis of the PCL-5 was found; cutoffs vary by population."
      ]
    },
    {
      "condition": "bipolar",
      "label": "Bipolar spectrum disorder",
      "status": "no_evidence",
      "prior": null,
      "evidence": [],
      "combined_likelihood_ratio": null,
      "probability": null,
      "references": [
        "Carvalho2015",
        "Hirschfeld2000"
      ],
      "caveats": [
        "Sensitivity depends strongly on setting and falls when people with known bipolar disorder are excluded.",
        "Primary-care and general-population estimates are very imprecise."
      ]
    }
  ],
  "safety": {
    "review_required": false,
    "priority": "routine",
    "reasons": []
  },
  "biomarker_model": {
    "status": "not_configured",
    "detail": "No multimodal condition model is deployed on this endpoint; condition probabilities use validated instruments only."
  }
}
Computed by the engine. Each call also carries an id and a created timestamp.

POST/v1/analyze

Analyze a session end to end

One call for a whole session: any of audio, physiological, facial and clinical-context inputs, plus the baseline. Runs every modality, merges the subject's biomarkers and returns the inference. Send multipart/form-data (audio part plus JSON parts named vocal, physiological, facial, clinical_context, baseline, context, options) or application/json without audio.

Bearer key requiredmultipart/form-dataapplication/json200: Analysis

Request body (JSON)

FieldTypeNotes
vocalobject
vocal.channel_rolesarray of stringA label per channel, for example ["clinician", "patient"]. Channels are treated as separated speakers. Constraints: at most 8 items.
vocal.language"en" | "ar"Transcript language: English or Arabic.
vocal.transcriptsarray of objectOptional transcripts. They unlock speaking and articulation rate and the language markers. Constraints: at most 8 items.
vocal.transcripts[].channelintegerChannel the transcript belongs to. Constraints: ≥ 0, ≤ 7.
vocal.transcripts[].textrequiredstringVerbatim transcript; keep fillers for disfluency markers. Constraints: at least 1 character, at most 100000 characters.
vocal.transcripts[].language"en" | "ar"Transcript language: English or Arabic.
vocal.subject_channelintegerFor /v1/analyze: which channel is the person being measured. Defaults to the channel labeled patient, else 0. Constraints: ≥ 0, ≤ 7.
physiologicalobject
physiological.heartobject
physiological.heart.rr_msarray of numberRR or inter-beat intervals in milliseconds, in order. Constraints: at least 2 items.
physiological.heart.ppgobjectRaw photoplethysmogram; systolic peaks are detected server-side (Elgendi 2013).
physiological.heart.ppg.sample_rate_hzrequirednumberConstraints: ≥ 20, ≤ 1000.
physiological.heart.ppg.samplesrequiredarray of numberConstraints: at least 1 item.
physiological.edaobject
physiological.eda.sample_rate_hzrequirednumberConstraints: ≥ 1, ≤ 1000.
physiological.eda.samples_usrequiredarray of numberSkin conductance in microsiemens. Constraints: at least 1 item.
physiological.eda.scr_min_amplitude_usnumberSCR amplitude criterion, 0.01 to 0.05 µS (default 0.05). Constraints: ≥ 0.01, ≤ 0.05.
physiological.sleepobject
physiological.sleep.nightsrequiredarray of objectConstraints: at most 400 items.
physiological.sleep.nights[].sleep_onsetrequiredstring (date-time)ISO 8601 date-time with a UTC offset.
physiological.sleep.nights[].wake_timerequiredstring (date-time)ISO 8601 date-time with a UTC offset.
physiological.sleep.nights[].total_sleep_minutesnumberConstraints: ≥ 0, ≤ 1440.
physiological.sleep.nights[].time_in_bed_minutesnumberConstraints: ≥ 0, ≤ 1440.
physiological.sleep.nights[].sleep_onset_latency_minutesnumberConstraints: ≥ 0, ≤ 600.
physiological.sleep.nights[].sleep_efficiency_pctnumberConstraints: ≥ 0, ≤ 100.
physiological.sleep.epochsobjectSleep/wake epochs for the Sleep Regularity Index.
physiological.sleep.epochs.startrequiredstring (date-time)ISO 8601 date-time with a UTC offset.
physiological.sleep.epochs.epoch_secondsrequired30 | 60
physiological.sleep.epochs.statesrequiredarray of 0 | 11 = asleep, 0 = awake, one value per epoch.
physiological.activityobject
physiological.activity.hourly_countsarray of numberHourly activity counts, starting at the top of an hour. Constraints: ≥ 0.
physiological.activity.daily_stepsarray of numberConstraints: ≥ 0.
facialobject
facial.fpsrequirednumberFrames per second of the landmarker output. Constraints: ≥ 1, ≤ 120.
facial.framesrequiredarray of null | objectConstraints: at least 1 item.
clinical_contextobject
clinical_context.instrumentsobject
clinical_context.instruments.phq9objectPHQ-9: nine items scored 0–3, in order; optional difficulty item.
clinical_context.instruments.phq9.itemsrequiredarray of integerConstraints: at least 9 items, at most 9 items.
clinical_context.instruments.phq9.difficultyintegerConstraints: ≥ 0, ≤ 3.
clinical_context.instruments.gad7objectGAD-7: seven items scored 0–3.
clinical_context.instruments.gad7.itemsrequiredarray of integerConstraints: at least 7 items, at most 7 items.
clinical_context.instruments.pcl5objectPCL-5: twenty items scored 0–4.
clinical_context.instruments.pcl5.itemsrequiredarray of integerConstraints: at least 20 items, at most 20 items.
clinical_context.instruments.mdqobjectMood Disorder Questionnaire: 13 yes/no items, question 2 and question 3.
clinical_context.instruments.mdq.itemsrequiredarray of booleanConstraints: at least 13 items, at most 13 items.
clinical_context.instruments.mdq.same_periodrequiredboolean
clinical_context.instruments.mdq.problemrequired"none" | "minor" | "moderate" | "serious"
clinical_context.instruments.cssrsobjectC-SSRS screener answers (questions 1–5 for the past month or since last contact; question 6 behavior).
clinical_context.instruments.cssrs.versionrequired"lifetime_recent" | "since_last_contact"
clinical_context.instruments.cssrs.wish_deadrequiredboolean
clinical_context.instruments.cssrs.thoughtsrequiredboolean
clinical_context.instruments.cssrs.methodboolean
clinical_context.instruments.cssrs.intentboolean
clinical_context.instruments.cssrs.planboolean
clinical_context.instruments.cssrs.behaviorrequiredboolean
clinical_context.instruments.cssrs.behavior_within_3_monthsboolean
clinical_context.transcriptobjectWhat the person said, for the language markers.
clinical_context.transcript.textrequiredstringConstraints: at least 1 character, at most 200000 characters.
clinical_context.transcript.language"en" | "ar"Transcript language: English or Arabic.
clinical_context.diagnosesarray of stringICD-10-CM codes from the record. Constraints: at most 50 items.
baselineobjectAs in /v1/inference.
contextobjectAs in /v1/inference.
optionsobjectAs in /v1/inference.
# The published sample request (synthetic, no real person's data)
curl -s https://www.medera.info/api/v1/samples/analyze -o analyze.json

curl -s https://www.medera.info/api/v1/analyze \
  -H "Authorization: Bearer mk_sandbox_medera_public" \
  -H "Content-Type: application/json" \
  --data @analyze.json
POST/v1/analyze
Sample request

Sends the synthetic sample to the live sandbox with the public key and shows the full response. Nothing personal is sent and nothing is stored.

Response for the published sample · 200
{
  "object": "analysis",
  "api_version": "v1",
  "mode": "sandbox",
  "engine": {
    "name": "medera-inference",
    "version": "1.0.0",
    "vocal": "BH-ASR voice layer 1.2.0 (TypeScript port, number-for-number with the Python reference)"
  },
  "intended_use": "Measured biomarkers and within-person change for research and clinician review. Not a diagnosis and not a medical device.",
  "modalities": {
    "vocal": null,
    "physiological": {
      "biomarkers": {
        "meanHrBpm": 69.8,
        "meanNnMs": 859.6,
        "sdnnMs": 30.47,
        "rmssdMs": 34.15,
        "sdsdMs": 34.2,
        "pnn50Pct": 13.14,
        "sd1Ms": 24.18,
        "sd2Ms": 35.66,
        "vlfPowerMs2": 4.8,
        "lfPowerMs2": 253.7,
        "hfPowerMs2": 641,
        "lfHfRatio": 0.396,
        "lfNu": 28.4,
        "hfNu": 71.6,
        "sclMeanUs": null,
        "scrPerMin": null,
        "scrAmplitudeMeanUs": null,
        "totalSleepTimeH": 7.44,
        "sleepEfficiencyPct": 89.3,
        "sleepOnsetLatencyMin": 20.1,
        "sleepMidpointSdMin": 20.5,
        "totalSleepTimeSdMin": 16.6,
        "sleepRegularityIndex": null,
        "activityMeanCountsPerHour": 736.36,
        "dailyStepsMean": 6799,
        "m10": 1350.64,
        "l5": 39.6,
        "relativeAmplitude": 0.943,
        "interdailyStability": 0.982,
        "intradailyVariability": 0.267
      },
      "quality": {
        "heart": {
          "beats": 350,
          "normal_fraction": 1,
          "duration_s": 300.9,
          "flags": [],
          "source": "rr"
        },
        "eda": null,
        "sleep": {
          "nights": 7,
          "flags": []
        },
        "activity": {
          "days": 7,
          "flags": []
        }
      }
    },
    "facial": {
      "biomarkers": {
        "smileIntensityMean": 0.2025,
        "smileFrequencyPerMin": 8,
        "duchenneSmileFraction": 1,
        "browLoweringMean": 0.1053,
        "lipCornerDepressorMean": 0.0346,
        "dimplerMean": 0.0352,
        "expressivityMean": 0.0532,
        "expressivityVariability": 0.0264,
        "blinkRatePerMin": 18,
        "downwardGazeFraction": 0.1822,
        "gazeAversionFraction": 0.1822,
        "headMotionDegPerSec": 1.576,
        "headPitchSdDeg": 1.332,
        "headYawSdDeg": 2.838
      },
      "quality": {
        "frames": 450,
        "face_frames": 450,
        "face_s": 30,
        "pose_frames": 450,
        "flags": []
      }
    },
    "clinical_context": {
      "instruments": {
        "phq9": {
          "instrument": "phq9",
          "total": 13,
          "band": "moderate",
          "band_range": "10–14",
          "item9": 0,
          "item9_positive": false,
          "difficulty": 2
        },
        "gad7": {
          "instrument": "gad7",
          "total": 9,
          "band": "mild",
          "band_range": "5–9"
        },
        "pcl5": null,
        "mdq": null,
        "cssrs": null
      },
      "language": {
        "words": 57,
        "firstPersonSingularPer100": 15.789,
        "absolutistPer100": 3.509,
        "negativeAffectPer100": 3.509,
        "fillerPer100": 1.754,
        "repetitionPer100": 0,
        "counts": {
          "first_person_singular": 9,
          "absolutist": 2,
          "negative_affect": 2,
          "filler": 1,
          "repetition": 0
        },
        "language": "en"
      },
      "biomarkers": {
        "words": 57,
        "firstPersonSingularPer100": 15.789,
        "absolutistPer100": 3.509,
        "negativeAffectPer100": 3.509,
        "fillerPer100": 1.754,
        "repetitionPer100": 0
      },
      "diagnoses": [
        {
          "code": "F32.1",
          "valid_format": true,
          "chapter5_block": "F30-F39",
          "block_title": "Mood [affective] disorders"
        }
      ],
      "safety": {
        "review_required": false,
        "priority": "routine",
        "reasons": []
      }
    }
  },
  "subject": null,
  "biomarkers": {
    "meanHrBpm": 69.8,
    "meanNnMs": 859.6,
    "sdnnMs": 30.47,
    "rmssdMs": 34.15,
    "sdsdMs": 34.2,
    "pnn50Pct": 13.14,
    "sd1Ms": 24.18,
    "sd2Ms": 35.66,
    "vlfPowerMs2": 4.8,
    "lfPowerMs2": 253.7,
    "hfPowerMs2": 641,
    "lfHfRatio": 0.396,
    "lfNu": 28.4,
    "hfNu": 71.6,
    "sclMeanUs": null,
    "scrPerMin": null,
    "scrAmplitudeMeanUs": null,
    "totalSleepTimeH": 7.44,
    "sleepEfficiencyPct": 89.3,
    "sleepOnsetLatencyMin": 20.1,
    "sleepMidpointSdMin": 20.5,
    "totalSleepTimeSdMin": 16.6,
    "sleepRegularityIndex": null,
    "activityMeanCountsPerHour": 736.36,
    "dailyStepsMean": 6799,
    "m10": 1350.64,
    "l5": 39.6,
    "relativeAmplitude": 0.943,
    "interdailyStability": 0.982,
    "intradailyVariability": 0.267,
    "smileIntensityMean": 0.2025,
    "smileFrequencyPerMin": 8,
    "duchenneSmileFraction": 1,
    "browLoweringMean": 0.1053,
    "lipCornerDepressorMean": 0.0346,
    "dimplerMean": 0.0352,
    "expressivityMean": 0.0532,
    "expressivityVariability": 0.0264,
    "blinkRatePerMin": 18,
    "downwardGazeFraction": 0.1822,
    "gazeAversionFraction": 0.1822,
    "headMotionDegPerSec": 1.576,
    "headPitchSdDeg": 1.332,
    "headYawSdDeg": 2.838,
    "words": 57,
    "firstPersonSingularPer100": 15.789,
    "absolutistPer100": 3.509,
    "negativeAffectPer100": 3.509,
    "fillerPer100": 1.754,
    "repetitionPer100": 0
  },
  "inference": {
    "tier": "review",
    "change": {
      "status": "computed",
      "method": "conformal",
      "baseline_sessions": 24,
      "alpha": {
        "watch": 0.05,
        "review": 0.01
      },
      "guarantee": "Watch: under exchangeability of the baseline sessions and this session (no real change), a domain is flagged with probability at most alpha_watch, with no distributional assumption when p-values are conformal; Benjamini–Hochberg across domains controls the false discovery rate. Review: the domain must also exceed alpha_review under the normal prediction model.",
      "notes": [],
      "biomarkers": [
        {
          "key": "meanHrBpm",
          "name": "Mean heart rate",
          "modality": "physiological",
          "value": 69.8,
          "baseline": {
            "mean": 66.122,
            "sd": 2.6602,
            "n": 24
          },
          "z": 1.355,
          "domain": "arousal_regulatory",
          "concern": "up",
          "concern_z": 1.355
        },
        {
          "key": "rmssdMs",
          "name": "RMSSD",
          "modality": "physiological",
          "value": 34.15,
          "baseline": {
            "mean": 43.8116,
            "sd": 4.5905,
            "n": 24
          },
          "z": -2.062,
          "domain": "arousal_regulatory",
          "concern": "down",
          "concern_z": 2.062
        },
        {
          "key": "sleepEfficiencyPct",
          "name": "Sleep efficiency",
          "modality": "physiological",
          "value": 89.3,
          "baseline": {
            "mean": 89.1211,
            "sd": 2.5576,
            "n": 24
          },
          "z": 0.069,
          "domain": "arousal_regulatory",
          "concern": "down",
          "concern_z": -0.069
        },
        {
          "key": "smileIntensityMean",
          "name": "Smile intensity",
          "modality": "facial",
          "value": 0.2025,
          "baseline": {
            "mean": 0.2787,
            "sd": 0.0454,
            "n": 24
          },
          "z": -1.642,
          "domain": "positive_valence",
          "concern": "down",
          "concern_z": 1.642
        },
        {
          "key": "expressivityMean",
          "name": "Facial expressivity",
          "modality": "facial",
          "value": 0.0532,
          "baseline": {
            "mean": 0.0888,
            "sd": 0.0089,
            "n": 24
          },
          "z": -3.92,
          "domain": "positive_valence",
          "concern": "down",
          "concern_z": 3.92
        },
        {
          "key": "gazeAversionFraction",
          "name": "Gaze aversion",
          "modality": "facial",
          "value": 0.1822,
          "baseline": {
            "mean": 0.1824,
            "sd": 0.0412,
            "n": 24
          },
          "z": -0.004,
          "domain": "social",
          "concern": "up",
          "concern_z": -0.004
        },
        {
          "key": "headMotionDegPerSec",
          "name": "Head motion",
          "modality": "facial",
          "value": 1.576,
          "baseline": {
            "mean": 6.0537,
            "sd": 1.3778,
            "n": 24
          },
          "z": -3.184,
          "domain": "sensorimotor",
          "concern": "down",
          "concern_z": 3.184
        },
        {
          "key": "firstPersonSingularPer100",
          "name": "First-person singular",
          "modality": "clinical",
          "value": 15.789,
          "baseline": {
            "mean": 6.6013,
            "sd": 1.3289,
            "n": 24
          },
          "z": 6.774,
          "domain": "social",
          "concern": "up",
          "concern_z": 6.774
        }
      ],
      "domains": [
        {
          "domain": "social",
          "label": "Social processes",
          "biomarkers": 2,
          "effective_biomarkers": 1.82,
          "score": 4.564,
          "p_value": 0.04,
          "p_conformal": 0.04,
          "p_parametric": 0,
          "q_value": 0.0533,
          "tier": "stable",
          "contributors": [
            {
              "key": "firstPersonSingularPer100",
              "concern_z": 6.774,
              "weight": 1
            },
            {
              "key": "gazeAversionFraction",
              "concern_z": -0.004,
              "weight": 1
            }
          ]
        },
        {
          "domain": "positive_valence",
          "label": "Positive valence systems",
          "biomarkers": 2,
          "effective_biomarkers": 1.54,
          "score": 3.449,
          "p_value": 0.04,
          "p_conformal": 0.04,
          "p_parametric": 0.0003,
          "q_value": 0.0533,
          "tier": "stable",
          "contributors": [
            {
              "key": "expressivityMean",
              "concern_z": 3.92,
              "weight": 1
            },
            {
              "key": "smileIntensityMean",
              "concern_z": 1.642,
              "weight": 1
            }
          ]
        },
        {
          "domain": "sensorimotor",
          "label": "Sensorimotor systems",
          "biomarkers": 1,
          "effective_biomarkers": 1,
          "score": 3.184,
          "p_value": 0.04,
          "p_conformal": 0.04,
          "p_parametric": 0.0007,
          "q_value": 0.0533,
          "tier": "stable",
          "contributors": [
            {
              "key": "headMotionDegPerSec",
              "concern_z": 3.184,
              "weight": 1
            }
          ]
        },
        {
          "domain": "arousal_regulatory",
          "label": "Arousal and regulatory systems",
          "biomarkers": 3,
          "effective_biomarkers": 1.88,
          "score": 1.528,
          "p_value": 0.08,
          "p_conformal": 0.08,
          "p_parametric": 0.0632,
          "q_value": 0.08,
          "tier": "stable",
          "contributors": [
            {
              "key": "rmssdMs",
              "concern_z": 2.062,
              "weight": 1
            },
            {
              "key": "meanHrBpm",
              "concern_z": 1.355,
              "weight": 1
            },
            {
              "key": "sleepEfficiencyPct",
              "concern_z": -0.069,
              "weight": 1
            }
          ]
        }
      ],
      "overall": {
        "score": 25.262,
        "p_value": 0.04,
        "p_conformal": 0.04,
        "p_parametric": 0,
        "tier": "review",
        "biomarkers": 8
      }
    },
    "conditions": [
      {
        "condition": "mdd",
        "label": "Major depression",
        "status": "computed",
        "prior": {
          "value": 0.1192,
          "source": "Levis 2019, primary care: 377 of 3,163 (11.9%)."
        },
        "evidence": [
          {
            "source": "instrument",
            "name": "PHQ-9",
            "observation": "total 13 (band 10–14)",
            "likelihood_ratio": 2.9091,
            "derivation": "(0.88 − 0.56) / (0.96 − 0.85)",
            "imprecise": false
          }
        ],
        "combined_likelihood_ratio": 2.9091,
        "probability": 0.2825,
        "references": [
          "Levis2019"
        ],
        "caveats": [
          "Interval likelihood ratios are derived from pooled sensitivity and specificity at cutoffs 5, 10 and 15; they are point estimates without confidence intervals.",
          "Levis 2019 excluded youth and psychiatric settings; supply your own pre-test probability there."
        ]
      },
      {
        "condition": "gad",
        "label": "Generalized anxiety disorder",
        "status": "computed",
        "prior": {
          "value": 0.0756,
          "source": "Spitzer 2006, primary care: 73 of 965 interviewed (7.6%)."
        },
        "evidence": [
          {
            "source": "instrument",
            "name": "GAD-7",
            "observation": "total 9 (below 10)",
            "likelihood_ratio": 0.3956,
            "derivation": "Cochrane 2025 at cutoff 10: Se 0.64, Sp 0.91; LR+ = 0.64 / 0.09, LR− = 0.36 / 0.91",
            "imprecise": false
          }
        ],
        "combined_likelihood_ratio": 0.3956,
        "probability": 0.0314,
        "references": [
          "Akturk2025"
        ],
        "caveats": [
          "Pooled estimates are heterogeneous across settings; the review calls them rough averages.",
          "The GAD-7 is used here as a screen for GAD, not for any anxiety disorder."
        ]
      },
      {
        "condition": "ptsd",
        "label": "Post-traumatic stress disorder",
        "status": "no_evidence",
        "prior": null,
        "evidence": [],
        "combined_likelihood_ratio": null,
        "probability": null,
        "references": [
          "Bovin2016",
          "NCPTSD_PCL5"
        ],
        "caveats": [
          "Validated in a high-prevalence veteran sample; in other settings supply a pre-test probability.",
          "No peer-reviewed diagnostic-accuracy meta-analysis of the PCL-5 was found; cutoffs vary by population."
        ]
      },
      {
        "condition": "bipolar",
        "label": "Bipolar spectrum disorder",
        "status": "no_evidence",
        "prior": null,
        "evidence": [],
        "combined_likelihood_ratio": null,
        "probability": null,
        "references": [
          "Carvalho2015",
          "Hirschfeld2000"
        ],
        "caveats": [
          "Sensitivity depends strongly on setting and falls when people with known bipolar disorder are excluded.",
          "Primary-care and general-population estimates are very imprecise."
        ]
      }
    ],
    "safety": {
      "review_required": false,
      "priority": "routine",
      "reasons": []
    },
    "biomarker_model": {
      "status": "not_configured",
      "detail": "No multimodal condition model is deployed on this endpoint; condition probabilities use validated instruments only."
    }
  }
}
Computed by the engine. Each call also carries an id and a created timestamp.