v2+ Vocabulary
0.3.0 - Working Draft to present the concept ideas (FO)

v2+ Vocabulary - Local Development build (v0.3.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

CodeSystem: Match Reason (2.4 - 1.0.0) (Experimental)

Official URL: http://terminology.hl7.org/v2plusvocab/CodeSystem/matchReasonV100 Version: 1.0.0
Active as of 2025-08-05 Computable Name: MatchReasonV100
Other Identifiers: OID:2.16.840.1.113883.18.243

Copyright/Legal: HL7 Inc., 2024

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.

This Code system is referenced in the content logical definition of the following value sets:

Properties

This code system defines the following properties for its concepts

NameCodeURITypeDescription
version introduced versionIntroduced http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionIntroduced string version when was this code introduced
version deprecated versionDeprecated http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionDeprecated string version when was this code deprecated
status status http://hl7.org/fhir/concept-properties#status code A code that indicates the status of the concept. Typical values are active, experimental, deprecated, and retired
comment, to suppress IG-publisher warning, to be replaced with standard later comment http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#comment string A string that provides additional detail pertinent to the use or understanding of the concept
usage usage http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#usage string usage notes for this code
modified modified http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#modified dateTime date of last modification

Concepts

This case-sensitive code system http://terminology.hl7.org/v2plusvocab/CodeSystem/matchReasonV100 defines the following codes:

CodeDisplayDefinitionversion introduced
DB Match on Date of Birth Match on Date of Birth 2.4
NA Match on Name (Alpha Match) Match on Name (Alpha Match) 2.4
NP Match on Name (Phonetic Match) Match on Name (Phonetic Match) 2.4
SS Match on Social Security Number Match on Social Security Number 2.4