Fact of Death Exchange FHIR Implementation Guide
0.2.0 - CI Build United States of America flag

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

CapabilityStatement: Fact of Death Receiver Capability Statement

Official URL: http://example.org/fhir/us/fod/CapabilityStatement/fod-receiver Version: 0.2.0
Standards status: Informative Maturity Level: 1 Computable Name: FODReceiver

Expectations of a Notification Receiver, typically an EHR, that accepts fact-of-death notifications. A receiver SHALL accept all three message events. Accepting a retraction is not optional: a receiver that can accept a death but not withdraw it cannot be corrected when a jurisdiction registers a death against the wrong individual.

Raw OpenAPI-Swagger Definition file | Download

Fact of Death Receiver Capability Statement

  • Implementation Guide Version: 0.2.0
  • FHIR Version: 4.0.1
  • Supported Formats: json, xml
  • Published on: 2026-08-07
  • Published by: HL7 International - Public Health Work Group

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

FHIR RESTful Capabilities

Mode: server

Notifications are delivered by invoking $process-message at the server root with a Fact of Death Notification Bundle as the message. A receiver that supports acknowledgement returns a Fact of Death Acknowledgement Bundle synchronously in the operation response.

Summary of System-wide Operations
ConformanceOperationDocumentation
SHALL$process-message

FHIR Messaging Capabilities

Messaging Capability

Supported Message(s)

ModeDefinition
receiverFact of Death Notification Message
receiverFact of Death Correction Message
receiverFact of Death Void Message
Documentation

A receiver matches each notification to a patient record using its own matching logic. Where it supports acknowledgement, it reports the outcome using the Fact of Death Match Outcome, including the case where no patient record matched.