HL7 v2.8.1 Vocabulary
0.2.0 - ci-build

HL7 v2.8.1 Vocabulary, published by HL7/FO. 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/frankoemig/hl7.v2.terminology.v281/ and changes regularly. See the Directory of published versions

## : Match Reason (2.8.1 - 1.0.0) - JSON Representation

Active as of 2026-03-13

Raw json | Download

    {
      "resourceType" : "CodeSystem",
      "id" : "matchReason",
      "text" : {
        "status" : "generated",
        "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><ul><li>Include all codes defined in <a href=\"CodeSystem-matchReason.html\"><code>http://terminology.hl7.org/v2plusvocab/CodeSystem/matchReason</code></a></li></ul></div>"
      },
      "extension" : [
        {
          "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-v2versionCreated",
          "valueString" : "2.8.1"
        },
        {
          "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-versionHistory",
          "valueString" : "generate correct history somehow"
        },
        {
          "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-tableNo",
          "valueString" : "0392"
        }
      ],
      "url" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/matchReason",
      "identifier" : [
        {
          "system" : "urn:ietf:rfc:3986",
          "value" : "urn:oid:2.16.840.1.113883.18.243"
        },
        {
          "system" : "urn:ietf:rfc:3986",
          "value" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/v2-0392"
        }
      ],
      "version" : "1.0.0",
      "name" : "MatchReason",
      "title" : "Match Reason (2.8.1 - 1.0.0)",
      "status" : "active",
      "experimental" : true,
      "date" : "2026-03-13T11:11:38+00:00",
      "publisher" : "HL7/FO",
      "contact" : [
        {
          "name" : "HL7/FO",
          "telecom" : [
            {
              "system" : "url",
              "value" : "http://www.hl7.org"
            }
          ]
        }
      ],
      "description" : "Code system of concepts identifying what search components (e.g., name, birthdate, social security number) of the record returned matched the original query where the responding system does not assign numeric match weights or confidence levels.  It provides a method for passing a descriptive indication of the reason a particular record was found.  Used in HL7 Version 2.x messaging in the Query Response Instance (QRI) segment.",
      "copyright" : "HL7 Inc., 2026",
      "caseSensitive" : true,
      "compositional" : false,
      "content" : "complete",
      "property" : [
        {
          "code" : "versionIntroduced",
          "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionIntroduced",
          "description" : "version when was this code introduced",
          "type" : "string"
        },
        {
          "code" : "versionDeprecated",
          "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionDeprecated",
          "description" : "version when was this code deprecated",
          "type" : "string"
        },
        {
          "code" : "status",
          "uri" : "http://hl7.org/fhir/concept-properties#status",
          "description" : "A code that indicates the status of the concept. Typical values are active, experimental, deprecated, and retired",
          "type" : "code"
        },
        {
          "code" : "comment",
          "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#comment",
          "description" : "A string that provides additional detail pertinent to the use or understanding of the concept",
          "type" : "string"
        },
        {
          "code" : "usage",
          "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#usage",
          "description" : "usage notes for this code",
          "type" : "string"
        },
        {
          "code" : "modified",
          "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#modified",
          "description" : "date of last modification",
          "type" : "dateTime"
        }
      ],
      "concept" : [
        {
          "code" : "DB",
          "display" : "Match on Date of Birth",
          "definition" : "Match on Date of Birth",
          "property" : [
            {
              "code" : "versionIntroduced",
              "valueString" : "2.4"
            }
          ]
        },
        {
          "code" : "NA",
          "display" : "Match on Name (Alpha Match)",
          "definition" : "Match on Name (Alpha Match)",
          "property" : [
            {
              "code" : "versionIntroduced",
              "valueString" : "2.4"
            }
          ]
        },
        {
          "code" : "NP",
          "display" : "Match on Name (Phonetic Match)",
          "definition" : "Match on Name (Phonetic Match)",
          "property" : [
            {
              "code" : "versionIntroduced",
              "valueString" : "2.4"
            }
          ]
        },
        {
          "code" : "SS",
          "display" : "Match on Social Security Number",
          "definition" : "Match on Social Security Number",
          "property" : [
            {
              "code" : "versionIntroduced",
              "valueString" : "2.4"
            }
          ]
        }
      ]
    }