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

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-07-20 Computable Name: NzAppointmentReasonCodes

Code system for NZ appointment reason codes

References

Logical Definition (CLD)

This value set includes codes based on the following rules:

 

Expansion

Expansion from tx.fhir.org based on:

This value set contains 12 concepts

SystemCodeDisplay (en)DefinitionJSONXML
http://snomed.info/sct  266934004Transport problem
http://snomed.info/sct  74964007Other
https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs  566531000210101Timely in person appointment unavailableService user unable to get into usual GP practice for in person appointment when required. GP booked / wait for appointment is too long
https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs  566541000210109Unable to attend in person due to impaired mobilityService user has difficulty traveling to clinics
https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs  566551000210107Lives in rural or remote locationService user has limited access to healthcare facilities in location of residence or current location
https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs  566561000210105Unable to attend in person due to work or family constraintService user has limited time / access to healthcare facilities due to work or family constraints / responsibilities
https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs  566571000210104Avoiding possible exposure to infectious diseaseService user has personal health concerns, immunocompromised status, or protecting vulnerable household members
https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs  566581000210102Telehealth appointment booked for convenienceService user does not have accessibility or booking constraints but prefers convenience of telehealth service
https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs  566351000210102Patient not registered - not neededNot registered in general practice
https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs  185369008Referred by pharmacistPharmacy has referred service user
https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs  659821000210106Referred by urgent care clinicReferred by urgent care
https://fhir-ig.digital.health.nz/shared-care/CodeSystem/nz-onlinegp-appointment-reason-codes-cs  301661000210103Referred by emergency departmentEmergency department has referred service user

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