write vital-sign Observations to FHIR R4 with correct LOINC codes and UCUM units

domain: fhir · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Set Observation.status to 'final' (or 'amended' for corrections) and Observation.category to a coding with system http://terminology.hl7.org/CodeSystem/observation-category and code 'vital-signs'.
  2. Populate Observation.code with the appropriate LOINC code for the vital sign (e.g. 8867-4 for heart rate, 8310-5 for body temperature, 55284-4 for blood pressure panel) and system http://loinc.org.
  3. For simple numeric values, set valueQuantity.value, valueQuantity.unit (display string), and valueQuantity.system to http://unitsofmeasure.org with valueQuantity.code set to the canonical UCUM code (e.g. /min, Cel, mm[Hg]).
  4. For blood pressure (a panel), use Observation.component[] with separate entries for systolic (8480-6) and diastolic (8462-4), each with their own valueQuantity.
  5. Set Observation.subject to a reference to the Patient resource and Observation.effectiveDateTime to the ISO 8601 timestamp of the measurement.
  6. POST to {base}/Observation or include in a transaction Bundle; validate the resource against the US Core Vital Signs profile before submission.

Known gotchas

Related routes

Query Observation resources using LOINC codes to retrieve lab results and vital signs
fhir · 6 steps · unrated
Validate a LOINC code against a FHIR ValueSet using the terminology $validate-code operation
hl7.org/fhir/R4 · 5 steps · unrated
Convert a C-CDA 2.1 Continuity of Care Document (CCD) to FHIR R4 resources using the HL7 C-CDA on FHIR mapping and validate the output against US Core profiles
hl7.org/fhir/us/ccda · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans