This page is part of the WOF Connect Implementation Guide (v0.1.3: Pre-Release Draft) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions
| Official URL: http://canonical.fhir.link/servicewell/wof-connect/OperationDefinition/FindAppointments | Version: 0.1.3 | |||
| Active as of 2026-04-02 | Computable Name: FindAppointments | |||
Finds available appointment opportunities (slots) and returns them as proposed Appointments.
This operation corresponds to the IHE ITI Scheduling $find operation and returns a Bundle of Appointment resources conforming to the IHE Scheduled Availability Bundle profile.
URL: [base]/Appointment/$find
Output parameters Profile:IHE ITI Scheduling Bundle Profile
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | start | 1..1 | dateTime | Start of the requested time window for which available appointment opportunities (slots) should be returned. This parameter is mandatory as per IHE ITI Scheduling $find. | ||
| IN | end | 1..1 | dateTime | End of the requested time window for which available appointment opportunities (slots) should be returned. This parameter is mandatory as per IHE ITI Scheduling $find. | ||
| IN | practitioner | 0..* | Reference (Wof Connect Practitioner) | Restrict the search to Appointments where a specific Practitioner is the performer. If multiple values are supplied, the server MAY treat them as an OR or AND filter as documented by the implementation. | ||
| IN | organization | 0..* | Reference (Wof Connect Economy Organization) | Restrict the search to Appointments associated with a specific Organization (e.g., business/clinic owner). | ||
| IN | visit-type | 0..* | string | Restrict the search to a specific visit type (service type). In this implementation, visit-type typically carries a WOF Connect service-type identifier (e.g., [system]|[code] where code maps to treatmentId). | ||
| OUT | return | 0..1 | Bundle | On success, returns a Bundle that SHALL conform to ihe-sched-avail-bundle, containing the resulting Appointment:
If the operation fails, an OperationOutcome is returned instead of this parameter. |