NZ Shared Digital Health Record API
1.1.3 - release
NZ Shared Digital Health Record API - Local Development build (v1.1.3) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Official URL: https://fhir-ig.digital.health.nz/sdhr/OperationDefinition/SDHRParticipationStatusOperation | Version: 1.1.3 | |||
| Active as of 2026-08-12 | Computable Name: ParticipationStatus | |||
This operation allows Shared Electronic Health Record (SEHR) systems to retrieve a patient's Shared Digital Health Record participation status.
For example response payloads for this operation see:
Parameters resource returned when the patient is not participating in the Shared Digital Health Record service.Parameters resource returned when the patient is participating in the Shared Digital Health Record service.To make a request to this operation the API Consumer must POST a Parameters payload to the operation URL (e.g. POST https://api.sdhr.digital.health.nz/s2s/$participation-status).
The operation is expected to be called by a healthcare provider on behalf of the patient, and the patient must be identified by their NHI.
The operation will return a Parameters resource containing the patient reference and participation status indicators.
URL: [base]/$participation-status
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | patient | 1..1 | Reference | Reference must be an NHI Patient URL with format https://api.hip.digital.health.nz/fhir/nhi/v1/Patient/ZZZ1111 or ZZZ11AA | ||
| OUT | hnzParticipationIndicator | 1..1 | boolean | Indicates whether the patient is currently participating in the Shared Digital Health Record service. |