Health New Zealand Te Whatu Ora Shared Care FHIR API
0.4.5 - release

Health New Zealand Te Whatu Ora Shared Care FHIR API - Local Development build (v0.4.5) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## ValueSet: NZ Appointment Reason Codes Code System

Official URL: https://fhir-ig.digital.health.nz/shared-care/ValueSet/nz-onlinegp-appointment-reason-codes | Version: 0.4.5
Draft as of 2026-03-03 | Computable Name: NzAppointmentReasonCodes

Code system for NZ appointment reason codes

References

- Online GP Appointment

### Logical Definition (CLD)

This value set includes codes based on the following rules:

- Include these codes as defined in `http://snomed.info/sct`

  Code | Display
  266934004 | Transport problem (finding)

- Include all codes defined in `https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs`

### Expansion

Expansion from tx.fhir.org based on:

- SNOMED CT International edition 01-Feb 2025
- codesystem NZ Appointment Reason Codes Code System v0.4.5 (CodeSystem)

This value set contains 8 concepts

Code | System | Display | Definition
266934004 | http://snomed.info/sct | Transport problem |
566531000210101 | https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs | Timely in person appointment unavailable | Service user unable to get into usual GP practice for in person appointment when required. GP booked / wait for appointment is too long
566541000210109 | https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs | Unable to attend in person due to impaired mobility | Service user has difficulty traveling to clinics
566551000210107 | https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs | Lives in rural or remote location | Service user has limited access to healthcare facilities in location of residence or current location
566561000210105 | https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs | Unable to attend in person due to work or family constraint | Service user has limited time / access to healthcare facilities due to work or family constraints / responsibilities
566571000210104 | https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs | Avoiding possible exposure to infectious disease | Service user has personal health concerns, immunocompromised status, or protecting vulnerable household members
566581000210102 | https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs | Telehealth appointment booked for convenience | Service user does not have accessibility or booking constraints but prefers convenience of telehealth service
566351000210102 | https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs | Patient not registered - not needed | Not registered in general practice

Explanation of the columns that may appear on this page:

Level | A few code lists that FHIR defines are hierarchical - each code is assigned a level. In this scheme, some codes are under other codes, and imply that the code they are under also applies
System | The source of the definition of the code (when the value set draws in codes defined elsewhere)
Code | The code (used as the code in the resource instance)
Display | The display (used in the display element of a Coding). If there is no display, implementers should not simply display the code, but map the concept into their application
Definition | An explanation of the meaning of the concept
Comments | Additional notes about how to use the code