FHIR Write-back

Voxtar can push each analysis into your EMR as a FHIR R4 Observation bundle, so voice biomarkers land next to the rest of the patient record — no manual entry, no separate dashboard. Write-back is opt-in per request and mapped to your configured endpoint.

Configuration

In the dashboard under Integrations → EMR, set your FHIR base URL, auth (SMART-on-FHIR client credentials or a bearer token), and the identifier system that maps a Voxtar external_id to a FHIR Patient. Voxtar resolves the subject reference at write time.

Triggering write-back

Pass write_to_ehr: true on POST /analyze. On completion Voxtar posts a transaction bundle and records the resulting resource ids on the analysis.

Observation mapping

Each panel becomes an Observation with a LOINC-coded component per biomarker, the panel score as the primary value, and a note carrying the baseline z-score and drift band.

{
  "resourceType": "Observation",
  "status": "preliminary",
  "category": [{ "coding": [{ "code": "survey" }] }],
  "code": { "text": "Voxtar respiratory voice biomarker panel" },
  "subject": { "reference": "Patient/subject-1042" },
  "effectiveDateTime": "2026-07-11T09:26:41Z",
  "valueQuantity": { "value": 0.62, "unit": "score" },
  "interpretation": [{ "text": "elevated (baseline_z 2.8)" }],
  "component": [
    { "code": { "text": "shimmer" }, "valueQuantity": { "value": 0.071 } },
    { "code": { "text": "hnr_db" }, "valueQuantity": { "value": 11.2 } }
  ],
  "derivedFrom": [{ "display": "Voxtar analysis an_5Tz7Lm" }]
}

Delivery & failures

Write-back is asynchronous and retried with backoff. Subscribe to the ehr.write.failed webhook to catch endpoints that reject a bundle, and re-drive from the stored analysis at any time.