Skip to content
healthdirect australia logo
Home
healthdirect australia logo
healthdirect australia logo

Medical problem?

Call 1800 022 222 - a free service where you can talk to a nurse or doctor who can help you know what to do.
 
Dial 000 in an emergency - If you need urgent medical help, call triple zero immediately
  1. Home/
  2. What we do/
  3. Our portfolio/
  4. National Health Services Directory/
  5. Developer and Integration Hub/
  6. Understanding the NHSD architecture

Developer and Integration Hub

Key standards adopted
Understanding the NHSD architecture
Overview of the integration process
NHSD products and documentation
Maintenance updates
Technical support

Understanding the NHSD architecture

Managing the data ingestion, data provision and maintenance in a comprehensive directory of healthcare services is a detailed end-to-end process. It begins with obtaining service data for collation and categorisation.

The NHSD architectural organisation structure example

NHSD high-level architecture, end-to-end

Once data is obtained, it is validated and organised into our data model to make it easily accessible to users. Data sources are engaged through formal relationships to provide regular updates and maintenance to support currency and accuracy of the directory.

NHSD FHIR entity relationships

The data model diagram below shows the NHSD FHIR entity relationships from the perspective of the Healthcare Service Resource and is followed with a description of each entity.

The NHSD architecture

NHSD FHIR entity data model

Organisation

An Organisation can be represented as a single practice or as a larger institution, agency or facility. The NHSD FHIR data model supports multi-level Organisation structures, which is often required for more complex organisations such as hospitals. An Organisation must have at least one Location, which provides address or coverage area information for the Healthcare Service/s provided.

Location

The Location provides address or coverage area information for the Healthcare Service. The Location also provides context for how the service is delivered, whether provided at a physical location, provided as a service in the home, or provided virtually. An Organisation must have at least one Location.

Healthcare Service

The Healthcare Service entity is at the core of the NHSD’s data architecture. Healthcare Services are delivered at a Location by an Organisation. In the NHSD model the Healthcare Service allows the association of secure messaging endpoints and thus a channel for delivery to that service.

Practitioner Role

A Healthcare Service is delivered by a Practitioner Role, which can be filled by a specific Practitioner who is working in that role at a point in time. The Practitioner provides details of an individual who delivers services in one or more Practitioner Roles. 

Practitioner

A Practitioner is the individual person that is delivering the health-related service at a Healthcare Service under at least one Practitioner Role. 

Endpoint

Endpoints ensure secure electronic messages, such as discharge summaries and referrals, are delivered to the correct services. A Healthcare Service or a Practitioner Role may have secure messaging endpoints.

In developing the FHIR model for the NHSD the following assumptions were made about the relationship between the FHIR Resources. It should be noted that the Healthcare Service is the core of the NHSD data.

  • An Organisation provides a Healthcare Service at a Location;
  • A Healthcare Service is provided by a Practitioner at a Location; and
  • The data model supports n-levels of organisational (part of) relationships.

For further information on our FHIR data model, download

  • FHIR data model (R4) – inbound (Opens in new tab)
  • FHIR data model (R4) – outbound (Opens in new tab)

An example of how organisations may be structured in the NHSD is represented in the diagram below.

NHSD Organisation structure example diagram

NHSD Organisation structure example

Developer and Integration Hub

Key standards adopted
Understanding the NHSD architecture
Overview of the integration process
NHSD products and documentation
Maintenance updates
Technical support

healthdirect australia logo

Proudly supported by our Government partners.

(Opens in new tab) (Opens in new tab) (Opens in new tab) (Opens in new tab)Queensland Government logo (Opens in new tab) (Opens in new tab) (Opens in new tab) (Opens in new tab) (Opens in new tab)

Quick links

Our opportunitiesContact usTerms of useOur privacy commitmentPublications Stakeholder reporting login (Opens in new tab)

Follow us

This site is protected by reCAPTCHA and the Google Privacy Policy (Opens in new tab) and Terms of Service (Opens in new tab) apply.

Healthdirect Australia acknowledges the Traditional Owners of Country throughout Australia and their continuing connection to land, sea and community. We pay our respects to the Traditional Owners and to Elders both past and present.

© 2026 Healthdirect Australia Limited

This information is for your general information and use only and is not intended to be used as medical advice and should not be used to diagnose, treat, cure or prevent
any medical condition, nor should it be used for therapeutic purposes.

The information is not a substitute for independent professional advice and should not be used as an alternative to professional health care. If you have a particular medical
problem, please consult a healthcare professional.

Except as permitted under the Copyright Act 1968, this publication or any part of it may be reproduced, altered, adapted, stored and/or distributed in any form or by any means without the prior written permission of Healthdirect Australia
about.healthdirect.gov.au/we-are-healthdirect-australia (Opens in new tab)