Health Connect Australia Provider Directory FHIR Implementation Guide, published by Australian Digital Health Agency. This guide is not an authorized publication; it is the continuous build for version 0.2.0-preview built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/AuDigitalHealth/HealthConnect/ and changes regularly. See the Directory of published versions

CapabilityStatement: Health Connect Provider Directory Responder

Official URL: http://ns.electronichealth.net.au/hc/CapabilityStatement/health-connect-provider-directory-responder Version: 0.2.0-preview
Standards status: Draft Computable Name: HealthConnectProviderDirectoryResponder

Usage:Jurisdiction: Australia

Copyright/Legal: Copyright © 2025 Australian Digital Health Agency - All rights reserved. This content is licensed under a Creative Commons Attribution 4.0 International License. See https://creativecommons.org/licenses/by/4.0/

This CapabilityStatement resource defines the expected capabilities of the Health Connect Provider Directory Responder Actor when conforming to this implementation guide. The listed FHIR profiles, RESTful operations, and search parameters describe only those capabilities exposed for responding to Requester Actor requests. The Health Connect Provider Directory Responder supports additional internal and publishing operations that are not shown here; these are out of scope for this IG and are documented separately for publishing systems. The requirements of the Health Connect Provider Directory Responder may also be impacted by the rules of local jurisdictions or other contextual requirements.

Raw OpenAPI-Swagger Definition file | Download

Health Connect Provider Directory Responder

  • Implementation Guide Version: 0.2.0-preview
  • FHIR Version: 4.0.1
  • Supported Formats: SHALL support json, SHALL support xml
  • Published on: 2025-11-27
  • Published by: Australian Digital Health Agency

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

FHIR RESTful Capabilities

Mode: server

Security
Enable CORS: no
Security services supported: OAuth

All interactions SHALL be secured using OAuth protocols. It SHALL support authentication, authorisation, and audit logging in accordance with local policy and regulatory requirements.

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRSUCSearches_include_revincludeOperations
Provenancehttp://ns.electronichealth.net.au/hc/StructureDefinition/hc-provenance|0.2.0-previewyytargetProvenance:target
Organizationhttp://ns.electronichealth.net.au/hc/StructureDefinition/hc-organization|0.2.0-previewyyidentifier, name, typeOrganization:partOfLocation:organization, Provenance:target
Locationhttp://ns.electronichealth.net.au/hc/StructureDefinition/hc-location|0.2.0-previewyylocmailaddress, locationamenities, name, address, type, locationphysicaltype, nearLocation:managingOrganization, Location:endpointHealthcareService:location, Provenance:target
HealthcareServicehttp://ns.electronichealth.net.au/hc/StructureDefinition/hc-healthcareservice|0.2.0-previewyylanguages, hsbilling, allday, daysofweek, starttime, endtime, service-typeHealthcareService:location, HealthcareService:providedBy, HealthcareService:endpointPractitionerRole:healthcareService, Provenance:target
PractitionerRolehttp://ns.electronichealth.net.au/hc/StructureDefinition/hc-practitionerrole|0.2.0-previewyylanguages, allday, daysofweek, starttime, endtime, identifier, roletypePractitionerRole:practitioner, PractitionerRole:healthcareService, PractitionerRole:organization, PractitionerRole:location, PractitionerRole:endpointProvenance:target
Practitionerhttp://ns.electronichealth.net.au/hc/StructureDefinition/hc-practitioner|0.2.0-previewyyidentifier, regprof, rsg, genderIdentity, identifier-r5, namePractitionerRole:practitioner, Provenance:target
Endpointhttp://ns.electronichealth.net.au/hc/StructureDefinition/hc-endpoint|0.2.0-previewyyepurl, payloadmimetype, hcepi, name, connection-type, payload-typeHealthcareService:endpoint, Location:endpoint, PractitionerRole:endpoint, Provenance:target
Base System Profile
HC Provenanceversion: 0.2.0-preview)
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports
    read

    Read HC Provenance records

    search-type

    Search HC Provenance records by various parameters

Documentation

HC Provenance resources track the lineage of data retrieved, updated, or verified from external systems of record.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLtargetreference
 
Base System Profile
HC Organizationversion: 0.2.0-preview)
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type.

Documentation

This section defines the supported interactions for the HC Organization profile of the Organization resource type.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLidentifiertoken
SHALLnamestring
SHALLtypetoken
 
Base System Profile
HC Locationversion: 0.2.0-preview)
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type.

Documentation

This section describes the supported interactions for the HC Location profile. Each Location resource conforming to this profile identifies a physical or virtual place associated with healthcare services in the Health Connect Provider Directory, enabling clients to discover, filter, and reference service delivery sites.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLlocmailaddressstring
SHALLlocationamenitiestoken
SHALLnamestring
SHALLaddressstring
SHALLtypetoken
SHALLlocationphysicaltypetoken
SHALLnearspecial
 
Base System Profile
HC HealthcareServiceversion: 0.2.0-preview)
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type.

Documentation

This section describes the supported interactions for the HC Healthcare Service profile. Each HealthcareService resource conforming to this profile identifies a healthcare service in the Health Connect Provider Directory, enabling clients to discover, filter, and reference healthcare services that are provided.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLlanguagesstring
SHALLhsbillingtoken
SHALLalldaytoken
SHALLdaysofweektoken
SHALLstarttimenumber
SHALLendtimenumber
SHALLservice-typetoken
 
Base System Profile
HC PractitionerRoleversion: 0.2.0-preview)
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type.

Documentation

This section defines the supported interactions for the HC Practitioner Role profile of the PractitionerRole resource type. Each PractitionerRole resource conforming to the HC Practitioner Role profile describes a practitioner in a role at a healthcare service.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLlanguagesstring
SHALLalldaytoken
SHALLdaysofweektoken
SHALLstarttimenumber
SHALLendtimenumber
SHALLidentifiertoken
SHALLroletypestring
 
Base System Profile
HC Practitionerversion: 0.2.0-preview)
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type.

Documentation

This section describes the supported interactions for the HC Practitioner profile. Each Practitioner resource conforming to this profile represents an individual healthcare provider registered in the Health Connect Provider Directory, enabling clients to search, identify, and reference practitioners and their associated roles and service locations.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLidentifiertoken
SHALLregprofstring
SHALLrsgtoken
SHALLgenderIdentitytoken
SHALLidentifier-r5token
SHALLnamestring
 
Base System Profile
HC Endpointversion: 0.2.0-preview)
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type.

Documentation

This section describes the supported interactions for the HC Endpoint profile. Each Endpoint resource conforming to this profile provides connection details for electronic services available through the Health Connect Provider Directory, allowing clients to discover and interact with service endpoints in a standardised way.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLepurluri
SHALLpayloadmimetypetoken
SHALLhcepitoken
SHALLnamestring
SHALLconnection-typetoken
SHALLpayload-typetoken