# Healthcare Service - SMART Scheduling Links v1.0.0-ballot

## Resource Profile: Healthcare Service 

 
The Health Service resource is used to describe a single healthcare service or category of services that are provided by an organization at a location. The location of the services could be virtual, as with telemedicine services. This profile provides a scheduling-optimized view of healthcare service offerings, enabling discovery and booking of appointments when no specific practitioner is required or specified. 

**Example Usage Scenarios**

The following are example usage scenarios for the SMART Scheduling Links HealthcareService profile:

* Query services provided by an organization at a location

### Mandatory and Must Support Data Elements

The following data elements must always be present or must be supported if the data is present in the sending system. They are presented below in a simple human-readable explanation. Profile specific guidance and examples are provided as well. The Formal Views below provides the formal summary, definitions, and terminology requirements.

**Each HealthcareService Must Have:**

* id
* active
* type
* specialty
* location
* name

**Each HealthcareService Must Support:**

* providedBy
* category
* comment
* telecom
* serviceProvisionCode
* appointmentRequired
* availableTime
* notAvailable

**Usages:**

* Refer to this Profile: [PractitionerRole](StructureDefinition-smart-scheduling-practitionerRole.md)
* Examples for this Profile: [Primary Care Appointments - Online Booking](HealthcareService-ExampleHealhCareService.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/hl7.fhir.uv.smart-scheduling-links|current/StructureDefinition/smart-scheduling-healthcare-service)

### Formal Views of Profile Content

 [Description Differentials, Snapshots, and other representations](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](../StructureDefinition-smart-scheduling-healthcare-service.csv), [Excel](../StructureDefinition-smart-scheduling-healthcare-service.xlsx), [Schematron](../StructureDefinition-smart-scheduling-healthcare-service.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "smart-scheduling-healthcare-service",
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode" : "pa"
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 2,
    "_valueInteger" : {
      "extension" : [{
        "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
        "valueCanonical" : "http://hl7.org/fhir/uv/smart-scheduling-links/ImplementationGuide/hl7.fhir.uv.smart-scheduling-links"
      }]
    }
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode" : "trial-use",
    "_valueCode" : {
      "extension" : [{
        "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
        "valueCanonical" : "http://hl7.org/fhir/uv/smart-scheduling-links/ImplementationGuide/hl7.fhir.uv.smart-scheduling-links"
      }]
    }
  }],
  "url" : "http://hl7.org/fhir/uv/smart-scheduling-links/StructureDefinition/smart-scheduling-healthcare-service",
  "version" : "1.0.0-ballot",
  "name" : "SmartSchedulingHealthcareService",
  "title" : "Healthcare Service",
  "status" : "active",
  "date" : "2026-04-20T23:02:44+00:00",
  "publisher" : "HL7 International / Patient Administration",
  "contact" : [{
    "name" : "HL7 International / Patient Administration",
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/pafm"
    },
    {
      "system" : "email",
      "value" : "pafm@lists.hl7.org"
    }]
  }],
  "description" : "The Health Service resource is used to describe a single healthcare service or \ncategory of services that are provided by an organization at a location. The \nlocation of the services could be virtual, as with telemedicine services. This \nprofile provides a scheduling-optimized view of healthcare service offerings, \nenabling discovery and booking of appointments when no specific practitioner is \nrequired or specified.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "code" : "001",
      "display" : "World"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "HealthcareService",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/HealthcareService",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "HealthcareService",
      "path" : "HealthcareService"
    },
    {
      "id" : "HealthcareService.id",
      "path" : "HealthcareService.id",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.active",
      "path" : "HealthcareService.active",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.providedBy",
      "path" : "HealthcareService.providedBy",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.category",
      "path" : "HealthcareService.category",
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.type",
      "path" : "HealthcareService.type",
      "min" : 1,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.specialty",
      "path" : "HealthcareService.specialty",
      "min" : 1,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.location",
      "path" : "HealthcareService.location",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/uv/smart-scheduling-links/StructureDefinition/smart-scheduling-location"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.name",
      "path" : "HealthcareService.name",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.comment",
      "path" : "HealthcareService.comment",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.telecom",
      "path" : "HealthcareService.telecom",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.serviceProvisionCode",
      "path" : "HealthcareService.serviceProvisionCode",
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.appointmentRequired",
      "path" : "HealthcareService.appointmentRequired",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.availableTime",
      "path" : "HealthcareService.availableTime",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.availableTime.daysOfWeek",
      "path" : "HealthcareService.availableTime.daysOfWeek",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.availableTime.allDay",
      "path" : "HealthcareService.availableTime.allDay",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.availableTime.availableStartTime",
      "path" : "HealthcareService.availableTime.availableStartTime",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.availableTime.availableEndTime",
      "path" : "HealthcareService.availableTime.availableEndTime",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.notAvailable",
      "path" : "HealthcareService.notAvailable",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.notAvailable.description",
      "path" : "HealthcareService.notAvailable.description",
      "mustSupport" : true
    },
    {
      "id" : "HealthcareService.notAvailable.during",
      "path" : "HealthcareService.notAvailable.during",
      "mustSupport" : true
    }]
  }
}

```
