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
// The happy path: a death registered in a hospital, with full demographics and an exact date and time of death.
{
"resourceType" : "Bundle",
"id" : "fod-notification-hospital-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" : "000184"
}
],
"system" : "http://vitalrecords.example.gov/fod-notification",
"value" : "IL-FOD-2026-0000184"
},
"type" : "message",
"timestamp" : "2026-08-05T09:12:00-05:00",
"entry" : [
{
"fullUrl" : "urn:uuid:0f1e2d3c-4b5a-6978-8796-a5b4c3d2e1f0",
"resource" : {
"resourceType" : "MessageHeader",
"id" : "IL-FOD-2026-0000184",
"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-0000184\"> </a><p class=\"res-header-id\"><b>Generated Narrative: MessageHeader IL-FOD-2026-0000184</b></p><a name=\"IL-FOD-2026-0000184\"> </a><a name=\"hcIL-FOD-2026-0000184\"> </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><td><b>Receiver</b></td></tr><tr><td style=\"display: none\">*</td><td>Example Health System</td><td><a href=\"https://ehr.example.org/fhir/$process-message\">https://ehr.example.org/fhir/$process-message</a></td><td>Example Health System</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-correction-example.html#urn-uuid-2b3c4d5e-6f70-4812-9345-6a7b8c9d0e1f\">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" : "Example Health System",
"endpoint" : "https://ehr.example.org/fhir/$process-message",
"receiver" : {
"display" : "Example Health System"
}
}
],
"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:2b3c4d5e-6f70-4812-9345-6a7b8c9d0e1f"
}
]
}
},
{
"fullUrl" : "urn:uuid:1a2b3c4d-5e6f-4708-9192-a3b4c5d6e7f8",
"resource" : {
"resourceType" : "Patient",
"id" : "fod-decedent-hospital-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-hospital-example\"> </a><p class=\"res-header-id\"><b>Generated Narrative: Patient fod-decedent-hospital-example</b></p><a name=\"fod-decedent-hospital-example\"> </a><a name=\"hcfod-decedent-hospital-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;\">Alice Rose Nakamura (official) Female, DoB: 1949-03-11 ( Social Security number)</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=\"Alternate names (see the one above)\">Alt. Name:</td><td colspan=\"3\">Alice Whitfield (Name changed for Marriage)</td></tr><tr><td style=\"background-color: #f3f5da\" title=\"Ways to contact the Patient\">Contact Detail</td><td colspan=\"3\"><ul><li>ph: 217-555-0142(Home)</li><li>1428 Elm Street Springfield IL 62704 US </li></ul></td></tr></table></div>"
},
"identifier" : [
{
"type" : {
"coding" : [
{
"system" : "http://terminology.hl7.org/CodeSystem/v2-0203",
"code" : "SS"
}
]
},
"system" : "http://hl7.org/fhir/sid/us-ssn",
"value" : "999451234"
}
],
"name" : [
{
"use" : "official",
"family" : "Nakamura",
"given" : [
"Alice",
"Rose"
]
},
{
"use" : "maiden",
"family" : "Whitfield",
"given" : [
"Alice"
]
}
],
"telecom" : [
{
"system" : "phone",
"value" : "217-555-0142",
"use" : "home"
}
],
"gender" : "female",
"birthDate" : "1949-03-11",
"deceasedBoolean" : true,
"address" : [
{
"line" : [
"1428 Elm Street"
],
"city" : "Springfield",
"district" : "Sangamon",
"state" : "IL",
"postalCode" : "62704",
"country" : "US"
}
]
}
},
{
"fullUrl" : "urn:uuid:2b3c4d5e-6f70-4812-9345-6a7b8c9d0e1f",
"resource" : {
"resourceType" : "Observation",
"id" : "fod-death-date-hospital-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-hospital-example\"> </a><p class=\"res-header-id\"><b>Generated Narrative: Observation fod-death-date-hospital-example</b></p><a name=\"fod-death-date-hospital-example\"> </a><a name=\"hcfod-death-date-hospital-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-correction-example.html#urn-uuid-3c4d5e6f-7081-4923-a456-7b8c9d0e1f20\">Location Springfield General Hospital</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-hospital-example.html#urn-uuid-1a2b3c4d-5e6f-4708-9192-a3b4c5d6e7f8\">Alice Rose Nakamura (official) Female, DoB: 1949-03-11 ( Social Security number)</a></p><p><b>value</b>: 2026-07-29 14:22:00-0500</p><p><b>method</b>: <span title=\"Codes:{http://hl7.org/fhir/us/vrdr/CodeSystem/vrdr-date-of-death-determination-methods-cs exact}\">Exact</span></p><blockquote><p><b>component</b></p><p><b>code</b>: <span title=\"Codes:{http://loinc.org 80616-6}\">Date and time pronounced dead [US Standard Certificate of Death]</span></p><p><b>value</b>: 2026-07-29 14:35:00-0500</p></blockquote><blockquote><p><b>component</b></p><p><b>code</b>: <span title=\"Codes:{http://loinc.org 58332-8}\">Location of death</span></p><p><b>value</b>: <span title=\"Codes:{http://snomed.info/sct 16983000}\">Death in hospital</span></p></blockquote></div>"
},
"extension" : [
{
"url" : "http://hl7.org/fhir/StructureDefinition/event-location",
"valueReference" : {
"reference" : "urn:uuid:3c4d5e6f-7081-4923-a456-7b8c9d0e1f20"
}
}
],
"status" : "final",
"code" : {
"coding" : [
{
"system" : "http://loinc.org",
"code" : "81956-5",
"display" : "Date+time of death"
}
]
},
"subject" : {
"reference" : "urn:uuid:1a2b3c4d-5e6f-4708-9192-a3b4c5d6e7f8"
},
"valueDateTime" : "2026-07-29T14:22:00-05:00",
"method" : {
"coding" : [
{
"system" : "http://hl7.org/fhir/us/vrdr/CodeSystem/vrdr-date-of-death-determination-methods-cs",
"code" : "exact",
"display" : "Exact"
}
]
},
"component" : [
{
"code" : {
"coding" : [
{
"system" : "http://loinc.org",
"code" : "80616-6",
"display" : "Date and time pronounced dead [US Standard Certificate of Death]"
}
]
},
"valueDateTime" : "2026-07-29T14:35:00-05:00"
},
{
"code" : {
"coding" : [
{
"system" : "http://loinc.org",
"code" : "58332-8",
"display" : "Location of death"
}
]
},
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://snomed.info/sct",
"code" : "16983000",
"display" : "Death in hospital"
}
]
}
}
]
}
},
{
"fullUrl" : "urn:uuid:3c4d5e6f-7081-4923-a456-7b8c9d0e1f20",
"resource" : {
"resourceType" : "Location",
"id" : "fod-death-location-hospital-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-hospital-example\"> </a><p class=\"res-header-id\"><b>Generated Narrative: Location fod-death-location-hospital-example</b></p><a name=\"fod-death-location-hospital-example\"> </a><a name=\"hcfod-death-location-hospital-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>: Springfield General Hospital</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>: 800 North Rutledge Street Springfield IL 62702 US </p></div>"
},
"name" : "Springfield General Hospital",
"type" : [
{
"coding" : [
{
"system" : "http://hl7.org/fhir/us/vrdr/CodeSystem/vrdr-location-type-cs",
"code" : "death"
}
]
}
],
"address" : {
"line" : [
"800 North Rutledge Street"
],
"city" : "Springfield",
"district" : "Sangamon",
"state" : "IL",
"postalCode" : "62702",
"country" : "US"
}
}
},
{
"fullUrl" : "urn:uuid:5d4c3b2a-1908-4716-8524-3f2e1d0c9b8a",
"resource" : {
"resourceType" : "Organization",
"id" : "fod-source-organization-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-example\"> </a><p class=\"res-header-id\"><b>Generated Narrative: Organization fod-source-organization-example</b></p><a name=\"fod-source-organization-example\"> </a><a name=\"hcfod-source-organization-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><p><b>address</b>: 925 East Ridgely Avenue Springfield IL 62702 US </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"
}
],
"address" : [
{
"line" : [
"925 East Ridgely Avenue"
],
"city" : "Springfield",
"state" : "IL",
"postalCode" : "62702",
"country" : "US"
}
]
}
},
{
"fullUrl" : "urn:uuid:4e5f6071-8293-4a45-b567-8c9d0e1f2031",
"resource" : {
"resourceType" : "Provenance",
"id" : "fod-provenance-hospital-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-hospital-example\"> </a><p class=\"res-header-id\"><b>Generated Narrative: Provenance fod-provenance-hospital-example</b></p><a name=\"fod-provenance-hospital-example\"> </a><a name=\"hcfod-provenance-hospital-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-correction-example.html#urn-uuid-2b3c4d5e-6f70-4812-9345-6a7b8c9d0e1f\">Observation Date+time of death</a></p><p>Summary</p><table class=\"grid\"><tr><td>Occurrence</td><td>2026-08-03</td></tr><tr><td>Recorded</td><td>2026-08-05 09:12: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:2b3c4d5e-6f70-4812-9345-6a7b8c9d0e1f"
}
],
"occurredDateTime" : "2026-08-03",
"recorded" : "2026-08-05T09:12: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"
}
}
]
}
}
]
}