# Appointment Reason Codes (2.8.2 - 1.0.0) - HL7 v2.8.2 Vocabulary v0.2.0

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **Appointment Reason Codes (2.8.2 - 1.0.0)**

## CodeSystem: Appointment Reason Codes (2.8.2 - 1.0.0) (Experimental) 

| | |
| :--- | :--- |
| *Official URL*:http://terminology.hl7.org/v2plusvocab/CodeSystem/appointmentReason | *Version*:1.0.0 |
| Active as of 2026-03-13 | *Computable Name*:AppointmentReason |
| *Other Identifiers:*OID:2.16.840.1.113883.18.169, urn:ietf:rfc:3986#Uniform Resource Identifier (URI)#http://terminology.hl7.org/v2plusvocab/CodeSystem/v2-0276 | |
| **Copyright/Legal**: HL7 Inc., 2026 | |

 
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. 

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

* [Hl7VSappointmentReasonCodes](ValueSet-hl7VSappointmentReasonCodes.md)



## Resource Content

```json
{
  "resourceType" : "CodeSystem",
  "id" : "appointmentReason",
  "extension" : [{
    "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-v2versionCreated",
    "valueString" : "2.8.2"
  },
  {
    "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.8.2 - 1.0.0)",
  "status" : "active",
  "experimental" : true,
  "date" : "2026-03-13T11:11:43+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"
    }]
  }]
}

```
