HL7 v2.9 Vocabulary
0.2.0 - ci-build

HL7 v2.9 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.v29/ and changes regularly. See the Directory of published versions

## : Appointment Reason Codes (2.9 - 1.0.0) - JSON Representation

Active as of 2026-03-13

Raw json | Download

    {
      "resourceType" : "CodeSystem",
      "id" : "appointmentReason",
      "text" : {
        "status" : "generated",
        "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><ul><li>Include all codes defined in <a href=\"CodeSystem-appointmentReason.html\"><code>http://terminology.hl7.org/v2plusvocab/CodeSystem/appointmentReason</code></a></li></ul></div>"
      },
      "extension" : [
        {
          "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-v2versionCreated",
          "valueString" : "2.9"
        },
        {
          "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-versionHistory",
          "valueString" : "generate correct history somehow"
        },
        {
          "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-tableNo",
          "valueString" : "0276"
        }
      ],
      "url" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/appointmentReason",
      "identifier" : [
        {
          "system" : "urn:ietf:rfc:3986",
          "value" : "urn:oid:2.16.840.1.113883.18.169"
        },
        {
          "system" : "urn:ietf:rfc:3986",
          "value" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/v2-0276"
        }
      ],
      "version" : "1.0.0",
      "name" : "AppointmentReason",
      "title" : "Appointment Reason Codes (2.9 - 1.0.0)",
      "status" : "active",
      "experimental" : true,
      "date" : "2026-03-13T11:11:50+00:00",
      "publisher" : "HL7/FO",
      "contact" : [
        {
          "name" : "HL7/FO",
          "telecom" : [
            {
              "system" : "url",
              "value" : "http://www.hl7.org"
            }
          ]
        }
      ],
      "description" : "Code system of concepts used to describe the kind of appointment or the reason why an appointment has been scheduled.  Used in HL7 Version 2.x messaging in the ARQ 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" : "CHECKUP",
          "display" : "A routine check-up, such as an annual physical",
          "definition" : "A routine check-up, such as an annual physical",
          "property" : [
            {
              "code" : "versionIntroduced",
              "valueString" : "2.3"
            }
          ]
        },
        {
          "code" : "EMERGENCY",
          "display" : "Emergency appointment",
          "definition" : "Emergency appointment",
          "property" : [
            {
              "code" : "versionIntroduced",
              "valueString" : "2.3"
            }
          ]
        },
        {
          "code" : "FOLLOWUP",
          "display" : "A follow up visit from a previous appointment",
          "definition" : "A follow up visit from a previous appointment",
          "property" : [
            {
              "code" : "versionIntroduced",
              "valueString" : "2.3"
            }
          ]
        },
        {
          "code" : "ROUTINE",
          "display" : "Routine appointment - default if not valued",
          "definition" : "Routine appointment - default if not valued",
          "property" : [
            {
              "code" : "versionIntroduced",
              "valueString" : "2.3"
            }
          ]
        },
        {
          "code" : "WALKIN",
          "display" : "A previously unscheduled walk-in visit",
          "definition" : "A previously unscheduled walk-in visit",
          "property" : [
            {
              "code" : "versionIntroduced",
              "valueString" : "2.3"
            }
          ]
        }
      ]
    }