{
  "description": "A query operation that allows to search for healthcare service providers that offer a specific healthcare service. The general information about the HealthcareService identification itself is already available in advance, either as resource or via codes. ",
  "_filename": "OperationDefinition-healthcareService-provider-find.json",
  "package_name": "hl7.at.fhir.tc.wg.scheduling.r5",
  "date": "2026-08-31T12:30:29+00:00",
  "system": false,
  "publisher": "HL7® Austria, TC FHIR®",
  "instance": false,
  "name": "Find_HealthcareService_Provider",
  "type": "true",
  "experimental": null,
  "resourceType": "OperationDefinition",
  "title": null,
  "package_version": "1.0.0",
  "status": "active",
  "id": "8a174673-0850-4c9a-9d85-5740c8e4d909",
  "resource": [ "HealthcareService" ],
  "affectsState": false,
  "kind": "operation",
  "url": "https://fhir.hl7.at/tc/wg/scheduling/r5/OperationDefinition/healthcareService-provider-find",
  "code": "findHSP",
  "version": "1.0.0",
  "parameter": [ {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "healthcareService-reference",
    "type": "Reference",
    "documentation": "The full HealthcareService resource can be provided for this operation. The HealthcareService SHALL be active (HealthcareService.active=true). ",
    "targetProfile": [ "https://fhir.hl7.at/tc/wg/scheduling/r5/StructureDefinition/at-scheduling-healthcareservice" ]
  }, {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "healthcareService-category",
    "type": "string",
    "searchType": "token",
    "documentation": "The code of the category of the healthcare service. Each parameter value SHALL contain *both* the system property and the code property for a code using the general syntax `healthcareService-category=[system]|[code]`. See the examples below for how this is implemented."
  }, {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "healthcareService-type",
    "type": "string",
    "searchType": "token",
    "documentation": "The code of the type of the healthcare service. Each parameter value SHALL contain *both* the system property and the code property for a code using the general syntax `healthcareService-type=[system]|[code]`. See the examples below for how this is implemented."
  }, {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "healthcareService-specialty",
    "type": "string",
    "searchType": "token",
    "documentation": "The code of the specialty of the healthcare service. Each parameter value SHALL contain *both* the system property and the code property for a code using the general syntax `healthcareService-specialty=[system]|[code]`. See the examples below for how this is implemented."
  }, {
    "max": "*",
    "min": 0,
    "use": "in",
    "name": "healthcareService-location",
    "type": "Reference",
    "documentation": "The (physical) location where a healthcare service should be provided can be used as a search parameter.",
    "targetProfile": [ "http://hl7.org/fhir/StructureDefinition/Location" ]
  }, {
    "max": "*",
    "min": 0,
    "use": "in",
    "name": "healthcareService-zipCodeArea",
    "type": "string",
    "searchType": "string",
    "documentation": "The aera in which a healthcare service should be offered can be provided as search parameter. For that purpose the zip code(s) shall be used."
  }, {
    "max": "*",
    "min": 0,
    "use": "in",
    "name": "healthcareService-availability",
    "type": "Availability",
    "documentation": "The desired availabilities for the healthcare service. "
  }, {
    "max": "1",
    "min": 1,
    "use": "out",
    "name": "result",
    "type": "Bundle",
    "documentation": "The response will be a Bundle consisting of the HealthcareService resource and a list of healthcare service providers (Organization, Practitioner, PractitionerRole) that offer the requested service and an OperationOutcome with errors, warnings or information as a result of processing the operation."
  } ]
}