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

: Fact of Death Match Outcome Codes - JSON Representation

Page standards status: Informative Maturity Level: 1

Raw json | Download

{
  "resourceType" : "CodeSystem",
  "id" : "fod-match-outcome-cs",
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: CodeSystem fod-match-outcome-cs</b></p><a name=\"fod-match-outcome-cs\"> </a><a name=\"hcfod-match-outcome-cs\"> </a><p>This case-sensitive code system <code>http://example.org/fhir/us/fod/CodeSystem/fod-match-outcome-cs</code> defines the following codes:</p><table class=\"codes\"><tr><td style=\"white-space:nowrap\"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td></tr><tr><td style=\"white-space:nowrap\">matched<a name=\"fod-match-outcome-cs-matched\"> </a></td><td>Matched</td><td>The notification was matched to exactly one patient record and has been processed.</td></tr><tr><td style=\"white-space:nowrap\">no-match<a name=\"fod-match-outcome-cs-no-match\"> </a></td><td>No Match</td><td>No patient record matched the demographics in the notification. The receiver took no action on any patient record.</td></tr><tr><td style=\"white-space:nowrap\">multiple-candidates<a name=\"fod-match-outcome-cs-multiple-candidates\"> </a></td><td>Multiple Candidates</td><td>More than one patient record matched the demographics in the notification and the receiver could not safely select one. No patient record was updated.</td></tr><tr><td style=\"white-space:nowrap\">pending-manual-review<a name=\"fod-match-outcome-cs-pending-manual-review\"> </a></td><td>Pending Manual Review</td><td>The notification was accepted but routed to a human reviewer rather than being applied automatically. A further response may or may not follow.</td></tr></table></div>"
  },
  "extension" : [
    {
      "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger" : 1,
      "_valueInteger" : {
        "extension" : [
          {
            "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical" : "http://example.org/fhir/us/fod/ImplementationGuide/example.fhir.us.fod"
          }
        ]
      }
    },
    {
      "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode" : "informative",
      "_valueCode" : {
        "extension" : [
          {
            "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical" : "http://example.org/fhir/us/fod/ImplementationGuide/example.fhir.us.fod"
          }
        ]
      }
    }
  ],
  "url" : "http://example.org/fhir/us/fod/CodeSystem/fod-match-outcome-cs",
  "version" : "0.2.0",
  "name" : "FODMatchOutcomeCS",
  "title" : "Fact of Death Match Outcome Codes",
  "status" : "draft",
  "experimental" : false,
  "date" : "2026-08-07",
  "publisher" : "HL7 International - Public Health Work Group",
  "contact" : [
    {
      "telecom" : [
        {
          "system" : "url",
          "value" : "http://hl7.org/Special/committees/pher"
        }
      ]
    }
  ],
  "description" : "Codes a receiving system returns to report whether a fact-of-death notification could be matched to a patient record. These codes describe the outcome of the receiver's own matching process; this guide does not specify the matching algorithm itself.",
  "jurisdiction" : [
    {
      "coding" : [
        {
          "system" : "urn:iso:std:iso:3166",
          "code" : "US"
        }
      ]
    }
  ],
  "caseSensitive" : true,
  "valueSet" : "http://example.org/fhir/us/fod/ValueSet/fod-match-outcome-vs",
  "content" : "complete",
  "count" : 4,
  "concept" : [
    {
      "code" : "matched",
      "display" : "Matched",
      "definition" : "The notification was matched to exactly one patient record and has been processed."
    },
    {
      "code" : "no-match",
      "display" : "No Match",
      "definition" : "No patient record matched the demographics in the notification. The receiver took no action on any patient record."
    },
    {
      "code" : "multiple-candidates",
      "display" : "Multiple Candidates",
      "definition" : "More than one patient record matched the demographics in the notification and the receiver could not safely select one. No patient record was updated."
    },
    {
      "code" : "pending-manual-review",
      "display" : "Pending Manual Review",
      "definition" : "The notification was accepted but routed to a human reviewer rather than being applied automatically. A further response may or may not follow."
    }
  ]
}