Fact of Death Exchange FHIR Implementation Guide
0.2.0 - CI Build
Fact of Death Exchange FHIR Implementation Guide
0.2.0 - CI Build
Fact of Death Exchange FHIR Implementation Guide, published by HL7 International - Public Health Work Group. This guide is not an authorized publication; it is the continuous build for version 0.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/shpringman/fhir-fod/ and changes regularly. See the Directory of published versions
<!-- A death at home discovered some time after it occurred, so only the month and year are known.
This decedent has no Social Security Number on the record; the matching invariant is met
through birth date plus address instead. -->
<Bundle xmlns="http://hl7.org/fhir">
<id value="fod-notification-home-partial-date-example"/>
<meta>
<profile
value="http://example.org/fhir/us/fod/StructureDefinition/fod-notification-bundle"/>
</meta>
<identifier>
<extension
url="http://hl7.org/fhir/us/vr-common-library/StructureDefinition/CertificateNumber">
<valueString value="002911"/>
</extension>
<system value="http://vitalrecords.example.gov/fod-notification"/>
<value value="IL-FOD-2026-0002911"/>
</identifier>
<type value="message"/>
<timestamp value="2026-08-06T16:40:00-05:00"/>
<entry>
<fullUrl value="urn:uuid:a0b1c2d3-e4f5-4607-8819-2a3b4c5d6e7f"/>
<resource>
<MessageHeader>
<id value="IL-FOD-2026-0002911"/>
<meta>
<profile
value="http://example.org/fhir/us/fod/StructureDefinition/fod-message-header"/>
</meta>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><a name="MessageHeader_IL-FOD-2026-0002911"> </a><p class="res-header-id"><b>Generated Narrative: MessageHeader IL-FOD-2026-0002911</b></p><a name="IL-FOD-2026-0002911"> </a><a name="hcIL-FOD-2026-0002911"> </a><div style="display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%"><p style="margin-bottom: 0px"/><p style="margin-bottom: 0px">Profile: <a href="StructureDefinition-fod-message-header.html">Fact of Death Message Header</a></p></div><p><b>event</b>: <a href="CodeSystem-fod-notification-event-cs.html#fod-notification-event-cs-fact-of-death-notification">Fact of Death Notification Event Codes: fact-of-death-notification</a> (Fact of Death Notification)</p><h3>Destinations</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Name</b></td><td><b>Endpoint</b></td></tr><tr><td style="display: none">*</td><td>Prairie Family Medicine</td><td><a href="https://ehr.example.org/fhir/$process-message">https://ehr.example.org/fhir/$process-message</a></td></tr></table><p><b>sender</b>: <a href="Bundle-fod-correction-example.html#urn-uuid-5d4c3b2a-1908-4716-8524-3f2e1d0c9b8a">Illinois Department of Public Health, Division of Vital Records</a></p><h3>Sources</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Name</b></td><td><b>Endpoint</b></td></tr><tr><td style="display: none">*</td><td>Illinois Vital Records Notification Service</td><td><a href="https://vitalrecords.example.gov/fod">https://vitalrecords.example.gov/fod</a></td></tr></table><p><b>focus</b>: <a href="Bundle-fod-notification-home-partial-date-example.html#urn-uuid-c2d3e4f5-0617-4829-9a3b-4c5d6e7f8091">Observation Date+time of death</a></p></div>
</text>
<eventCoding>
<system
value="http://example.org/fhir/us/fod/CodeSystem/fod-notification-event-cs"/>
<code value="fact-of-death-notification"/>
</eventCoding>
<destination>
<name value="Prairie Family Medicine"/>
<endpoint value="https://ehr.example.org/fhir/$process-message"/>
</destination>
<sender>
<reference value="urn:uuid:5d4c3b2a-1908-4716-8524-3f2e1d0c9b8a"/>
<display
value="Illinois Department of Public Health, Division of Vital Records"/>
</sender>
<source>
<name value="Illinois Vital Records Notification Service"/>
<endpoint value="https://vitalrecords.example.gov/fod"/>
</source>
<focus>
<reference value="urn:uuid:c2d3e4f5-0617-4829-9a3b-4c5d6e7f8091"/>
</focus>
</MessageHeader>
</resource>
</entry>
<entry>
<fullUrl value="urn:uuid:b1c2d3e4-f506-4718-892a-3b4c5d6e7f80"/>
<resource>
<Patient>
<id value="fod-decedent-home-example"/>
<meta>
<profile
value="http://example.org/fhir/us/fod/StructureDefinition/fod-decedent"/>
</meta>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><a name="Patient_fod-decedent-home-example"> </a><p class="res-header-id"><b>Generated Narrative: Patient fod-decedent-home-example</b></p><a name="fod-decedent-home-example"> </a><a name="hcfod-decedent-home-example"> </a><div style="display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%"><p style="margin-bottom: 0px"/><p style="margin-bottom: 0px">Profile: <a href="StructureDefinition-fod-decedent.html">Fact of Death Decedent</a></p></div><p style="border: 1px #661aff solid; background-color: #e6e6ff; padding: 10px;">Daniel Okonjo (official) Male, DoB: 1957-11-02 ( http://vitalrecords.example.gov/death-record-id#IL-DR-2026-0002911)</p><hr/><table class="grid"><tr><td style="background-color: #f3f5da" title="Known status of Patient">Deceased:</td><td colspan="3">true</td></tr><tr><td style="background-color: #f3f5da" title="Ways to contact the Patient">Contact Detail</td><td colspan="3">77 Larkspur Lane Decatur IL 62521 US </td></tr></table></div>
</text>
<identifier>
<system value="http://vitalrecords.example.gov/death-record-id"/>
<value value="IL-DR-2026-0002911"/>
</identifier>
<name>
<use value="official"/>
<family value="Okonjo"/>
<given value="Daniel"/>
</name>
<gender value="male"/>
<birthDate value="1957-11-02"/>
<deceasedBoolean value="true"/>
<address>
<line value="77 Larkspur Lane"/>
<city value="Decatur"/>
<district value="Macon"/>
<state value="IL"/>
<postalCode value="62521"/>
<country value="US"/>
</address>
</Patient>
</resource>
</entry>
<entry>
<fullUrl value="urn:uuid:c2d3e4f5-0617-4829-9a3b-4c5d6e7f8091"/>
<resource>
<Observation>
<id value="fod-death-date-home-example"/>
<meta>
<profile
value="http://example.org/fhir/us/fod/StructureDefinition/fod-death-date"/>
</meta>
<text>
<status value="extensions"/>
<div xmlns="http://www.w3.org/1999/xhtml"><a name="Observation_fod-death-date-home-example"> </a><p class="res-header-id"><b>Generated Narrative: Observation fod-death-date-home-example</b></p><a name="fod-death-date-home-example"> </a><a name="hcfod-death-date-home-example"> </a><div style="display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%"><p style="margin-bottom: 0px"/><p style="margin-bottom: 0px">Profile: <a href="StructureDefinition-fod-death-date.html">Fact of Death Death Date</a></p></div><p><b>Event Location</b>: <a href="Bundle-fod-notification-home-partial-date-example.html#urn-uuid-d3e4f506-1728-493a-ab4c-5d6e7f809102">Location Decedent's residence</a></p><p><b>status</b>: Final</p><p><b>code</b>: <span title="Codes:{http://loinc.org 81956-5}">Date+time of death</span></p><p><b>subject</b>: <a href="Bundle-fod-notification-home-partial-date-example.html#urn-uuid-b1c2d3e4-f506-4718-892a-3b4c5d6e7f80">Daniel Okonjo (official) Male, DoB: 1957-11-02 ( http://vitalrecords.example.gov/death-record-id#IL-DR-2026-0002911)</a></p><p><b>value</b>: 2026-06</p><p><b>method</b>: <span title="Codes:{http://hl7.org/fhir/us/vrdr/CodeSystem/vrdr-date-of-death-determination-methods-cs approximate}">Approximate</span></p><h3>Components</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Code</b></td><td><b>Value[x]</b></td></tr><tr><td style="display: none">*</td><td><span title="Codes:{http://loinc.org 58332-8}">Location of death</span></td><td><span title="Codes:{http://snomed.info/sct 440081000124100}">Death in home</span></td></tr></table></div>
</text>
<extension
url="http://hl7.org/fhir/StructureDefinition/event-location">
<valueReference>
<reference value="urn:uuid:d3e4f506-1728-493a-ab4c-5d6e7f809102"/>
</valueReference>
</extension>
<status value="final"/>
<code>
<coding>
<system value="http://loinc.org"/>
<code value="81956-5"/>
<display value="Date+time of death"/>
</coding>
</code>
<subject>
<reference value="urn:uuid:b1c2d3e4-f506-4718-892a-3b4c5d6e7f80"/>
</subject>
<!-- The day and time of death are not known. The dateTime carries the precision that is
known, and the VRCL partial date/time extension states explicitly why the rest is absent. -->
<valueDateTime value="2026-06">
<extension
url="http://hl7.org/fhir/us/vr-common-library/StructureDefinition/Extension-partial-date-time-vr">
<extension url="year">
<valueUnsignedInt value="2026"/>
</extension>
<extension url="month">
<valueUnsignedInt value="6"/>
</extension>
<extension url="day">
<valueUnsignedInt>
<extension
url="http://hl7.org/fhir/StructureDefinition/data-absent-reason">
<valueCode value="unknown"/>
</extension>
</valueUnsignedInt>
</extension>
<extension url="time">
<valueTime>
<extension
url="http://hl7.org/fhir/StructureDefinition/data-absent-reason">
<valueCode value="unknown"/>
</extension>
</valueTime>
</extension>
</extension>
</valueDateTime>
<method>
<coding>
<system
value="http://hl7.org/fhir/us/vrdr/CodeSystem/vrdr-date-of-death-determination-methods-cs"/>
<code value="approximate"/>
<display value="Approximate"/>
</coding>
</method>
<component>
<code>
<coding>
<system value="http://loinc.org"/>
<code value="58332-8"/>
<display value="Location of death"/>
</coding>
</code>
<valueCodeableConcept>
<coding>
<system value="http://snomed.info/sct"/>
<code value="440081000124100"/>
<display value="Death in home"/>
</coding>
</valueCodeableConcept>
</component>
</Observation>
</resource>
</entry>
<entry>
<fullUrl value="urn:uuid:d3e4f506-1728-493a-ab4c-5d6e7f809102"/>
<resource>
<Location>
<id value="fod-death-location-home-example"/>
<meta>
<profile
value="http://example.org/fhir/us/fod/StructureDefinition/fod-death-location"/>
</meta>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><a name="Location_fod-death-location-home-example"> </a><p class="res-header-id"><b>Generated Narrative: Location fod-death-location-home-example</b></p><a name="fod-death-location-home-example"> </a><a name="hcfod-death-location-home-example"> </a><div style="display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%"><p style="margin-bottom: 0px"/><p style="margin-bottom: 0px">Profile: <a href="StructureDefinition-fod-death-location.html">Fact of Death Death Location</a></p></div><p><b>name</b>: Decedent's residence</p><p><b>type</b>: <span title="Codes:{http://hl7.org/fhir/us/vrdr/CodeSystem/vrdr-location-type-cs death}">Death Location</span></p><p><b>address</b>: Decatur IL US </p></div>
</text>
<name value="Decedent's residence"/>
<type>
<coding>
<system
value="http://hl7.org/fhir/us/vrdr/CodeSystem/vrdr-location-type-cs"/>
<code value="death"/>
</coding>
</type>
<!-- Generalized to city, county, and state rather than the full street address. -->
<address>
<city value="Decatur"/>
<district value="Macon"/>
<state value="IL"/>
<country value="US"/>
</address>
</Location>
</resource>
</entry>
<entry>
<fullUrl value="urn:uuid:5d4c3b2a-1908-4716-8524-3f2e1d0c9b8a"/>
<resource>
<Organization>
<id value="fod-source-organization-home-example"/>
<meta>
<profile
value="http://example.org/fhir/us/fod/StructureDefinition/fod-source-organization"/>
</meta>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><a name="Organization_fod-source-organization-home-example"> </a><p class="res-header-id"><b>Generated Narrative: Organization fod-source-organization-home-example</b></p><a name="fod-source-organization-home-example"> </a><a name="hcfod-source-organization-home-example"> </a><div style="display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%"><p style="margin-bottom: 0px"/><p style="margin-bottom: 0px">Profile: <a href="StructureDefinition-fod-source-organization.html">Fact of Death Source Organization</a></p></div><p><b>identifier</b>: <code>http://vitalrecords.example.gov/jurisdiction-id</code>/IL</p><p><b>active</b>: true</p><p><b>type</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/organization-type govt}">Government</span></p><p><b>name</b>: Illinois Department of Public Health, Division of Vital Records</p><p><b>telecom</b>: ph: 217-555-0100</p></div>
</text>
<identifier>
<system value="http://vitalrecords.example.gov/jurisdiction-id"/>
<value value="IL"/>
</identifier>
<active value="true"/>
<type>
<coding>
<system
value="http://terminology.hl7.org/CodeSystem/organization-type"/>
<code value="govt"/>
<display value="Government"/>
</coding>
</type>
<name
value="Illinois Department of Public Health, Division of Vital Records"/>
<telecom>
<system value="phone"/>
<value value="217-555-0100"/>
</telecom>
</Organization>
</resource>
</entry>
<entry>
<fullUrl value="urn:uuid:e4f50617-2839-4a4b-bc5d-6e7f80910213"/>
<resource>
<Provenance>
<id value="fod-provenance-home-example"/>
<meta>
<profile
value="http://example.org/fhir/us/fod/StructureDefinition/fod-provenance"/>
</meta>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><a name="Provenance_fod-provenance-home-example"> </a><p class="res-header-id"><b>Generated Narrative: Provenance fod-provenance-home-example</b></p><a name="fod-provenance-home-example"> </a><a name="hcfod-provenance-home-example"> </a><div style="display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%"><p style="margin-bottom: 0px"/><p style="margin-bottom: 0px">Profile: <a href="StructureDefinition-fod-provenance.html">Fact of Death Provenance</a></p></div><p>Provenance for <a href="Bundle-fod-notification-home-partial-date-example.html#urn-uuid-c2d3e4f5-0617-4829-9a3b-4c5d6e7f8091">Observation Date+time of death</a></p><p>Summary</p><table class="grid"><tr><td>Occurrence</td><td>2026-08-04</td></tr><tr><td>Recorded</td><td>2026-08-06 16:40:00-0500</td></tr></table><p><b>Agents</b></p><table class="grid"><tr><td><b>Type</b></td><td><b>who</b></td></tr><tr><td><span title="Codes:{http://terminology.hl7.org/CodeSystem/provenance-participant-type author}">Author</span></td><td><a href="Bundle-fod-correction-example.html#urn-uuid-5d4c3b2a-1908-4716-8524-3f2e1d0c9b8a">Organization Illinois Department of Public Health, Division of Vital Records</a></td></tr></table></div>
</text>
<target>
<reference value="urn:uuid:c2d3e4f5-0617-4829-9a3b-4c5d6e7f8091"/>
</target>
<occurredDateTime value="2026-08-04"/>
<recorded value="2026-08-06T16:40:00-05:00"/>
<agent>
<type>
<coding>
<system
value="http://terminology.hl7.org/CodeSystem/provenance-participant-type"/>
<code value="author"/>
</coding>
</type>
<who>
<reference value="urn:uuid:5d4c3b2a-1908-4716-8524-3f2e1d0c9b8a"/>
</who>
</agent>
</Provenance>
</resource>
</entry>
</Bundle>