<status value="active"/> <kind value="operation"/> <date value="2026-04-20T08:10:56+00:00"/> <publisher value="Service Well AB"/> <contact> <name value="Service Well AB"/> <telecom> <system value="url"/> <value value="https://servicewell.se"/> </telecom> <telecom> <system value="email"/> <value value="info@servicewell.se"/> </telecom> </contact> <contact> <name value="Service well"/> <telecom> <system value="email"/> <value value="info@servicewell.se"/> <use value="work"/> </telecom> </contact> <description value="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."/> <affectsState value="false"/> <code value="find"/> <base value="https://profiles.ihe.net/ITI/Scheduling/OperationDefinition/appointment-find"/> <resource value="Appointment"/> <system value="false"/> <type value="true"/> <instance value="false"/> <outputProfile value="https://canonical.fhir.link/servicewell/wof-portal/StructureDefinition/portal-available-appointment"/> <parameter> <name value="start"/> <use value="in"/> <min value="1"/> <max value="1"/> <documentation value="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."/> <type value="dateTime"/> </parameter> <parameter> <name value="end"/> <use value="in"/> <min value="1"/> <max value="1"/> <documentation value="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."/> <type value="dateTime"/> </parameter> <parameter> <name value="practitioner"/> <use value="in"/> <min value="0"/> <max value="*"/> <documentation value="Restrict the search to Appointments where a specific Practitioner is the performer. Practitioner is not exposed as a standalone API resource in WOF Portal. This parameter therefore uses a `Reference` with `identifier` populated for the logical Practitioner concept, instead of a resolvable FHIR resource reference. This follows the IHE ITI-style parameter pattern where the parameter type remains `Reference`, but the logical target is carried using `Reference.identifier`. **Reference.identifier.system:** `https://canonical.fhir.link/servicewell/wof-portal/identifier-system/endpoint-identifier-system-for-practitioner/{endpointId}` **Reference.identifier.value:** source-system primary key for the practitioner"/> <type value="Reference"/> </parameter> <parameter> <name value="location"/> <use value="in"/> <min value="0"/> <max value="*"/> <documentation value="Restrict the search to Appointments at a specific location. **Format:** `Location/{id}` **Example:** `?location=Location/1234`"/> <type value="Reference"/> <targetProfile value="http://portal.wof.purified.link/fhir/StructureDefinition/LocationArea"/> </parameter> <parameter> <name value="organization"/> <use value="in"/> <min value="0"/> <max value="*"/> <documentation value="Restrict the search to Appointments associated with a specific billing organization. BillingOrganization is not exposed as a standalone API resource in WOF Portal. This parameter therefore uses a `Reference` with `identifier` populated for the logical BillingOrganization concept, instead of a resolvable FHIR resource reference. This follows the IHE ITI -style parameter pattern where the parameter type remains `Reference`, but the logical target is carried using `Reference.identifier`. **Reference.identifier.system:** `https://canonical.fhir.link/servicewell/wof-portal/identifier-system/endpoint-identifier-system-for-billingorganization/{endpointId}` **Reference.identifier.value:** source-system primary key for the billing organization"/> <type value="Reference"/> </parameter> <parameter> <name value="visit-type"/> <use value="in"/> <min value="0"/> <max value="*"/> <documentation value="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)."/> <type value="string"/> </parameter> <parameter> <name value="healthcareService"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="Restrict the search to a specific HealthcareService. **Format:** `HealthcareService/{id}` **Example:** `?healthcareService=HealthcareService/1234`"/> <type value="Reference"/> <targetProfile value="https://canonical.fhir.link/servicewell/wof-portal/StructureDefinition/healthcare-service-portal"/> </parameter> <parameter> <name value="practitionerRole"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="Restrict the search to a specific PractitionerRole. **Format:** `PractitionerRole/{id}` **Example:** `?practitionerRole=PractitionerRole/1234`"/> <type value="Reference"/> <targetProfile value="https://canonical.fhir.link/servicewell/wof-portal/StructureDefinition/practitioner-role-portal"/> </parameter> <parameter> <name value="return"/> <use value="out"/> <min value="0"/> <max value="1"/> <documentation value="On success, returns a Bundle that SHALL conform to ihe-sched-avail-bundle, containing the resulting Appointment: - status 'proposed' for available appointment opportunities (slots) Bundels conforming to ihe-sched-avail-bundle: - [portal-find-appointment-bundle](./StructureDefinition-portal-find-appointment-bundle.html) If the operation fails, an OperationOutcome is returned instead of this parameter."/> <type value="Bundle"/> <targetProfile value="https://canonical.fhir.link/servicewell/wof-portal/StructureDefinition/portal-find-appointment-bundle"/> </parameter> </OperationDefinition>

Generated Narrative: OperationDefinition FindAppointments

URL: [base]/Appointment/$find

Output parameters Profile:Available Appointment Portal

Parameters

Use Name Scope Cardinality Type Binding Documentation

start

1..1

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.

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.

practitioner

0..*

Reference

Restrict the search to Appointments where a specific Practitioner is the performer.

Practitioner is not exposed as a standalone API resource in WOF Portal. This parameter therefore uses a Reference with identifier populated for the logical Practitioner concept, instead of a resolvable FHIR resource reference.

This follows the IHE ITI-style parameter pattern where the parameter type remains Reference, but the logical target is carried using Reference.identifier.

Reference.identifier.system: https://canonical.fhir.link/servicewell/wof-portal/identifier-system/endpoint-identifier-system-for-practitioner/{endpointId}

Reference.identifier.value: source-system primary key for the practitioner

location

0..*

Reference (Location Area)

Restrict the search to Appointments at a specific location.

Format: Location/{id}

Example: ?location=Location/1234

organization

0..*

Reference

Restrict the search to Appointments associated with a specific billing organization.

BillingOrganization is not exposed as a standalone API resource in WOF Portal. This parameter therefore uses a Reference with identifier populated for the logical BillingOrganization concept, instead of a resolvable FHIR resource reference.

This follows the IHE ITI -style parameter pattern where the parameter type remains Reference, but the logical target is carried using Reference.identifier.

Reference.identifier.system: https://canonical.fhir.link/servicewell/wof-portal/identifier-system/endpoint-identifier-system-for-billingorganization/{endpointId}

Reference.identifier.value: source-system primary key for the billing organization

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).

healthcareService

0..1

Reference (HealthcareServicePortal)

Restrict the search to a specific HealthcareService.

Format: HealthcareService/{id}

Example: ?healthcareService=HealthcareService/1234

practitionerRole

0..1

Reference (PractitionerRolePortal)

Restrict the search to a specific PractitionerRole.

Format: PractitionerRole/{id}

Example: ?practitionerRole=PractitionerRole/1234