NZ Shared Digital Health Record API
1.0.1 - release

NZ Shared Digital Health Record API, published by Health New Zealand. This guide is not an authorized publication; it is the continuous build for version 1.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/tewhatuora/fhir-sdhr/ and changes regularly. See the Directory of published versions

## Extension: Client Last Updated

Official URL: https://fhir-ig.digital.health.nz/sdhr/StructureDefinition/hnz-sdhr-client-last-updated-extension | Version: 1.0.1
Active as of 2026-06-05 | Computable Name: ClientLastUpdatedExtension

Extension to record the last time a resource was updated by the source system. When consuming applications are writing data to the SDHR API they can use this extension to record the `LastUpdated` timestamp in their system

Context of Use

This extension may be used on the following element(s)

- Element ID: `Condition`
- Element ID: `Observation`
- Element ID: `AllergyIntolerance`

Usage info

Usages:

- Use this Extension: SDHRAllergyIntolerance, SDHRCondition and SDHRObservation
- Examples for this Extension: AllergyIntolerance/AllergyIntoleranceExample, AllergyIntolerance/AllergyIntoleranceExample2, Bundle/SearchConditionResponseExample, Bundle/SearchConfidentialRecordsResponseExample... Show 4 more, Bundle/SearchWithRecordsWithheldExample, Condition/ConditionHypertensionExample, Condition/ConditionRespiratoryExample and Observation/ObservationVitalSignsExample
- Search Parameters using this Extension: AllergyIntoleranceClientLastUpdated, ConditionClientLastUpdated and ObservationClientLastUpdated

You can also check for usages in the FHIR IG Statistics

### Formal Views of Extension Content

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

- Differential Table
- Snapshot Table
- Statistics/References
- All

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Client Last Updated
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "https://fhir-ig.digital.health.nz/sdhr/StructureDefinition/hnz-sdhr-client-last-updated-extension"
value[x] |  | 0..1 | dateTime | Value of extension
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Client Last Updated
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "https://fhir-ig.digital.health.nz/sdhr/StructureDefinition/hnz-sdhr-client-last-updated-extension"
value[x] |  | 0..1 | dateTime | Value of extension
Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type dateTime: Extension to record the last time a resource was updated by the source system. When consuming applications are writing data to the SDHR API they can use this extension to record the `LastUpdated` timestamp in their system

Differential View

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Client Last Updated
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "https://fhir-ig.digital.health.nz/sdhr/StructureDefinition/hnz-sdhr-client-last-updated-extension"
value[x] |  | 0..1 | dateTime | Value of extension
Documentation for this format

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Client Last Updated
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "https://fhir-ig.digital.health.nz/sdhr/StructureDefinition/hnz-sdhr-client-last-updated-extension"
value[x] |  | 0..1 | dateTime | Value of extension
Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type dateTime: Extension to record the last time a resource was updated by the source system. When consuming applications are writing data to the SDHR API they can use this extension to record the `LastUpdated` timestamp in their system

Other representations of profile: CSV, Excel, Schematron

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`