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.
{
"resourceType" : "Bundle",
"id" : "fod-notification-home-partial-date-example",
"meta" : {
"profile" : [
🔗 "http://example.org/fhir/us/fod/StructureDefinition/fod-notification-bundle"
]
},
"identifier" : {
"extension" : [
{
"url" : "http://hl7.org/fhir/us/vr-common-library/StructureDefinition/CertificateNumber",
"valueString" : "002911"
}
],
"system" : "http://vitalrecords.example.gov/fod-notification",
"value" : "IL-FOD-2026-0002911"
},
"type" : "message",
"timestamp" : "2026-08-06T16:40:00-05:00",
"entry" : [
{
"fullUrl" : "urn:uuid:a0b1c2d3-e4f5-4607-8819-2a3b4c5d6e7f",
"resource" : {
"resourceType" : "MessageHeader",
"id" : "IL-FOD-2026-0002911",
"meta" : {
"profile" : [
🔗 "http://example.org/fhir/us/fod/StructureDefinition/fod-message-header"
]
},
"text" : {
"status" : "generated",
"div" : "<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>"
},
"eventCoding" : {
"system" : "http://example.org/fhir/us/fod/CodeSystem/fod-notification-event-cs",
"code" : "fact-of-death-notification"
},
"destination" : [
{
"name" : "Prairie Family Medicine",
"endpoint" : "https://ehr.example.org/fhir/$process-message"
}
],
"sender" : {
"reference" : "urn:uuid:5d4c3b2a-1908-4716-8524-3f2e1d0c9b8a",
"display" : "Illinois Department of Public Health, Division of Vital Records"
},
"source" : {
"name" : "Illinois Vital Records Notification Service",
"endpoint" : "https://vitalrecords.example.gov/fod"
},
"focus" : [
{
"reference" : "urn:uuid:c2d3e4f5-0617-4829-9a3b-4c5d6e7f8091"
}
]
}
},
{
"fullUrl" : "urn:uuid:b1c2d3e4-f506-4718-892a-3b4c5d6e7f80",
"resource" : {
"resourceType" : "Patient",
"id" : "fod-decedent-home-example",
"meta" : {
"profile" : [
🔗 "http://example.org/fhir/us/fod/StructureDefinition/fod-decedent"
]
},
"text" : {
"status" : "generated",
"div" : "<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>"
},
"identifier" : [
{
"system" : "http://vitalrecords.example.gov/death-record-id",
"value" : "IL-DR-2026-0002911"
}
],
"name" : [
{
"use" : "official",
"family" : "Okonjo",
"given" : [
"Daniel"
]
}
],
"gender" : "male",
"birthDate" : "1957-11-02",
"deceasedBoolean" : true,
"address" : [
{
"line" : [
"77 Larkspur Lane"
],
"city" : "Decatur",
"district" : "Macon",
"state" : "IL",
"postalCode" : "62521",
"country" : "US"
}
]
}
},
{
"fullUrl" : "urn:uuid:c2d3e4f5-0617-4829-9a3b-4c5d6e7f8091",
"resource" : {
"resourceType" : "Observation",
"id" : "fod-death-date-home-example",
"meta" : {
"profile" : [
🔗 "http://example.org/fhir/us/fod/StructureDefinition/fod-death-date"
]
},
"text" : {
"status" : "extensions",
"div" : "<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>"
},
"extension" : [
{
"url" : "http://hl7.org/fhir/StructureDefinition/event-location",
"valueReference" : {
"reference" : "urn:uuid:d3e4f506-1728-493a-ab4c-5d6e7f809102"
}
}
],
"status" : "final",
"code" : {
"coding" : [
{
"system" : "http://loinc.org",
"code" : "81956-5",
"display" : "Date+time of death"
}
]
},
"subject" : {
"reference" : "urn:uuid:b1c2d3e4-f506-4718-892a-3b4c5d6e7f80"
},
"valueDateTime" : "2026-06",
"_valueDateTime" : // 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.
{
"extension" : [
{
"url" : "http://hl7.org/fhir/us/vr-common-library/StructureDefinition/Extension-partial-date-time-vr",
"extension" : [
{
"url" : "year",
"valueUnsignedInt" : 2026
},
{
"url" : "month",
"valueUnsignedInt" : 6
},
{
"url" : "day",
"_valueUnsignedInt" : {
"extension" : [
{
"url" : "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
"valueCode" : "unknown"
}
]
}
},
{
"url" : "time",
"_valueTime" : {
"extension" : [
{
"url" : "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
"valueCode" : "unknown"
}
]
}
}
]
}
]
},
"method" : {
"coding" : [
{
"system" : "http://hl7.org/fhir/us/vrdr/CodeSystem/vrdr-date-of-death-determination-methods-cs",
"code" : "approximate",
"display" : "Approximate"
}
]
},
"component" : [
{
"code" : {
"coding" : [
{
"system" : "http://loinc.org",
"code" : "58332-8",
"display" : "Location of death"
}
]
},
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://snomed.info/sct",
"code" : "440081000124100",
"display" : "Death in home"
}
]
}
}
]
}
},
{
"fullUrl" : "urn:uuid:d3e4f506-1728-493a-ab4c-5d6e7f809102",
"resource" : {
"resourceType" : "Location",
"id" : "fod-death-location-home-example",
"meta" : {
"profile" : [
🔗 "http://example.org/fhir/us/fod/StructureDefinition/fod-death-location"
]
},
"text" : {
"status" : "generated",
"div" : "<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>"
},
"name" : "Decedent's residence",
"type" : [
{
"coding" : [
{
"system" : "http://hl7.org/fhir/us/vrdr/CodeSystem/vrdr-location-type-cs",
"code" : "death"
}
]
}
],
"address" : // Generalized to city, county, and state rather than the full street address.
{
"city" : "Decatur",
"district" : "Macon",
"state" : "IL",
"country" : "US"
}
}
},
{
"fullUrl" : "urn:uuid:5d4c3b2a-1908-4716-8524-3f2e1d0c9b8a",
"resource" : {
"resourceType" : "Organization",
"id" : "fod-source-organization-home-example",
"meta" : {
"profile" : [
🔗 "http://example.org/fhir/us/fod/StructureDefinition/fod-source-organization"
]
},
"text" : {
"status" : "generated",
"div" : "<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>"
},
"identifier" : [
{
"system" : "http://vitalrecords.example.gov/jurisdiction-id",
"value" : "IL"
}
],
"active" : true,
"type" : [
{
"coding" : [
{
"system" : "http://terminology.hl7.org/CodeSystem/organization-type",
"code" : "govt",
"display" : "Government"
}
]
}
],
"name" : "Illinois Department of Public Health, Division of Vital Records",
"telecom" : [
{
"system" : "phone",
"value" : "217-555-0100"
}
]
}
},
{
"fullUrl" : "urn:uuid:e4f50617-2839-4a4b-bc5d-6e7f80910213",
"resource" : {
"resourceType" : "Provenance",
"id" : "fod-provenance-home-example",
"meta" : {
"profile" : [
🔗 "http://example.org/fhir/us/fod/StructureDefinition/fod-provenance"
]
},
"text" : {
"status" : "generated",
"div" : "<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>"
},
"target" : [
{
"reference" : "urn:uuid:c2d3e4f5-0617-4829-9a3b-4c5d6e7f8091"
}
],
"occurredDateTime" : "2026-08-04",
"recorded" : "2026-08-06T16:40:00-05:00",
"agent" : [
{
"type" : {
"coding" : [
{
"system" : "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
"code" : "author"
}
]
},
"who" : {
"reference" : "urn:uuid:5d4c3b2a-1908-4716-8524-3f2e1d0c9b8a"
}
}
]
}
}
]
}