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

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

OperationDefinition: Get an Appointment backfill's status

Official URL: https://fhir-ig.digital.health.nz/shared-care/OperationDefinition/DHOAppointmentBackfillStatus Version: 0.4.7
Active as of 2026-10-13 Computable Name: DHOAppointmentBackfillStatus

Reports on a backfill started with $backfill. Returns 202 with an X-Progress header while it runs, and 200 once it has finished. status is running, completed, failed, cancelled, or stale when a running job hasn't been updated for a while (its run was most likely cut short by a restart).

URL: [base]/Appointment/$backfill-status

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INjob1..1string

The job id $backfill returned

OUTstatus1..1code

running, completed, failed, cancelled or stale

OUTmode1..1code

The mode $backfill was started with

OUTstartedAt1..1instant
OUTupdatedAt1..1instant
OUTfinishedAt0..1instant
OUTpagesProcessed1..1integer
OUToutcome0..*

How many Appointments ended with one outcome, e.g. updated, skipped, error

OUToutcome.code1..1code
OUToutcome.count1..1integer
OUTnotFound0..1integer

Identifier runs only: how many requested identifiers FHIR CDR didn't have

OUTcancelRequested0..1boolean

true when $backfill-cancel has been called but the run hasn't stopped yet

OUTerror0..1string

Failed runs only: why