XS SM MD LG XL XXL

The HI Service is a national system for uniquely identifying individuals, healthcare provider individuals and healthcare provider organisations. Healthcare Identifiers allow us to have confidence that the correct information is associated with the correct individual at the point of care.

The Healthcare Identifiers Service (HI Service) is required for many aspects of Digital Health including Electronic Prescribing, Secure Messaging or My Health Record. Get started below.

Overview

Before building Digital Health functionality (such as Electronic Prescribing, Secure Messaging or My Health Record) your software must first be able to identify the three participants in a healthcare event; the patient, the healthcare provider individual, and the healthcare provider organisation. The HI Service stores identifiers for these three participants. The HI Service Business to Business (B2B) Gateway exposes SOAP based web services which allow your software to search for identifiers for these parties.

The HI Service consists of 3 types of identifiers;

  • Individual Healthcare Identifier (IHI), assigned to Healthcare consumers. Every Australian with a Medicare Card or Department of Veteran’s Affairs (DVA) card has automatically been assigned an IHI. 
  • Healthcare Provider Identifier–Individual - (HPI-I), assigned to Healthcare providers, I.e. a GP, Pharmacist, Nurse or Psychiatrist. Every healthcare provider registered with AHPRA has automatically been assigned an HPI-I. Some healthcare providers who aren’t AHPRA registered are eligible to apply for an HPI-I.
  • Healthcare Provider Identifier–Organisation (HPI-O), assigned to organisations such as General Practices, Pharmacies and Hospitals. Healthcare provider organisations must register for an HPI-O.
my-health-record-b2b-hi-services

If you are new to the HI Service and wish to register and begin development then please follow our developer guides below. If you would like to understand more about the Test and Go Live process then please view our overview here: HI Service - Test and Go Live

There are three recent changes for HI Service development which may be of interest to new and returning developers;

  • HI Service Conformance Testing is now conducted by the Digital Health Agency at no cost, previously it was conducted by a 3rd party testing laboratory with associated costs.
  • HI Service requirement 22000 is now mandatory. More information can be found in the related FAQs below.
  • Software will now use a NASH certificate to connect to the HI Service, previously your customers had the choice of using their Medicare Site Certificate or a NASH certificate to connect to the HI Service. More information can be found at: National Authentication (NASH)

Developer Guides

Refer below to access all Developer Guides including: 

If you are connecting your software to the My Health Record system then you may wish to follow our combined developer guides here:  

Healthcare Identifiers Integration Toolkit

The HI Integration Toolkit is a collection of sample code available in both .NET and Java. This toolkit is available for download via this website, GitHub and NuGet. If you are following the HI Service Developer Guides, you will be provided direction to download the .NET NuGet package in Guide 1. The Healthcare Identifiers Integration Toolkit contains libraries for B2B connectivity to the Healthcare Identifiers service, used to search for IHI, HPI-Is and HPI-Os. For more information refer to:   

Sample Code available from GitHub

Java based sample code equivalent to the dotnet code base. We are working on providing updates to the 'clinical-document-library' for existing and new CDA document types. Other clients are deemed sufficient as there have been no API changes.

Related content

Developer guides

HI Service - Registration and Certificates

In this guide, you will Register as a developer for the HI Service, Request Test Certificates and Test Environment Data, Install the Test Certificates locally, Import Certificates in CIS Software.

HI Service - IHI Lookup

Your software will need to conduct lookups for Individual Healthcare Identifiers (IHIs) for patients. 

HI Service - IHI Lookup - Test Cases

After successfully executing the IHI Lookup, it is important to modify your implementation to meet the Test Cases for the Use Cases we have built to UC.010 and UC.015.

HI Service - Test and Go Live

All products developed, or updated, to connect with the HI Service are required to undergo testing before production access is granted.

HI Service - FAQs

The following frequently asked questions relate to the use of Healthcare Identifiers in Health Software Systems.

NASH SHA-2 Certificates - Developer Guide

This Developer Guide is for the use of developers whose products connect to the Healthcare Identifiers (HI) Service, My Health Record, Electronic Prescribing and Secure Messaging with a National Authentication Service for Health (NASH) PKI Certificate.

Resources

Healthcare Identifiers Integration Toolkit v1.2

Product
EP-2610:2018
Status
Active
Version
1.2
The Healthcare Identifiers Integration Toolkit contains libraries for B2B connectivity to the Healthcare Identifiers service, used to search for IHI, HPI-Is and HPI-Os. The sample code and integration tools provided here should only be used in conjunction with the Agency's detailed specifications for the Healthcare Identifiers Service and, where appropriate…

Healthcare Identifiers Service - Support Documents v1.4

Product
EP-3503:2021
Status
Active
Version
1.4
This release of the end product contains a reorganisation of worksheets to provide for requirement #22000 and Electronic Prescribing has been introduced.   The supporting documents on this page provide background and guidance for healthcare provider organisations, and conformance, compliance and accreditation requirements for vendors. For more…

Victoria IHI Pre-Implementation Project v1.0

Product
EP-1344:2011
Status
Active
Version
1.0
The primary objective of the Victorian IHI Pre-Implementation project is to develop a suite of system design artefacts to support integration of the national Individual Healthcare Identifier into health services’ patient administration systems. The project was conducted by the Department of Health, Victoria, under the HealthSMART program, and NEHTA…