# Health Connect Australia Provider Directory FHIR Implementation Guide

26.0.0 - Snapshot Sparked Testing 20260708

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 26.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/AuDigitalHealth/HCPD-Snapshot-26.0.0-SPARKED-Testing-20260708/ and changes regularly. See the Directory of published versions

## Batch Request Results

### Overview

This page describes step 3 of the Asynchronous Bulk Data Export Process Workflow - retrieving the request results.

Fetching results has four key components:

1. Preconditions
2. Request to server
3. Responses from server
4. Output file request

### Preconditions

The following preconditions, as documented in the status polling function, SHALL be met before retrieving the results of a bulk data export request:

1. The client must have received a `200 OK` response from the status polling request, indicating that the job is complete
2. The response's `output.url` must be stored for use in retrieving the results

### Request to server

Using the full url returned by the server, the client performs a final POST against the output URL to retrieve the outcome of the batch export.

#### HTTP method

The results are retrieved using the standard FHIR `POST` method to the output URL provided by the server.

#### Request body

No request body is required.

#### Example request

Request HTTP header

    POST [base]/Binary/VMxYkAvCKldql5wVAW2G7OKfTIvLnOsn
    Accept: application/fhir+ndjson

Request HTTP body

Absent

### Responses from server

#### Success response

The server responds with a `200 OK` status code and a `Content-Location` header indicating the location of the results file.

Response HTTP header

    HTTP/1.1 200 OK
    Content-Location: https://fhir-xrp.digitalhealth.gov.au/fhir/Binary/VMxYkAvCKldql5wVAW2G7OKfTIvLnOsn/_history/1
    Content-Disposition: Attachment;
    Content-Type: application/fhir+ndjson
    Content-Length: 8058
    Date: Tue, 11 Nov 2025 00:37:48 GMT

### Output file request

Clients can request the output files generated by the batch job by sending a `POST` request to the URLs provided in the `output` array of the job results.

Using the URLs supplied by the FHIR server in the Complete Status response body, a client MAY download the generated output files (one or more per resource type) within the time period specified in the Expires header (if present). If the requiresAccessToken field in the Complete Status body is set to true, the request SHALL include a valid access token.

The output files are in ndjson format, with one FHIR resource per line.

These NDJSON files may include resource instances of the usual resource types (for example `Location`, `Organization`, `Practitioner`, etc.). Bulk data extraction returns all resources regardless of active status or suppression. Implementers of the HCPD bulk data export SHALL respect the `suppressed` and `deactivated-by` extensions on returned resources, filtering these resources before displaying them to end consumers of the HCPD.

Example of a Location resource NDJSON file content in Health Connect Provider Directory:

    {"resourceType":"Location","id":"hcpd-location-ex-connectathon-1","meta":{"versionId":"3","lastUpdated":"2026-01-22T03:51:37.146+00:00","profile":["http://ns.electronichealth.net.au/hc/StructureDefinition/hcpd-location"],"extensions":[{"url":"http://ns.electronichealth.net.au/hc/StructureDefinition/hcpd-geographical-extract","valueCodeableConcept":{"coding":[{"system":"http://ns.electronichealth.net.au/hc/CodeSystem/extract-scope","code":"NSW-BORDERING","display":"NSW with bordering areas"}]}}]},"extension":[{"url":"http://ns.electronichealth.net.au/hc/StructureDefinition/hcpd-preferred-postal-address","valueAddress":{"use":"work","type":"postal","text":"PO Box 123, SYDNEY NSW 2000","line":["PO Box 123"],"city":"SYDNEY","state":"NSW","postalCode":"2000","country":"AU"}},{"url":"http://ns.electronichealth.net.au/hc/StructureDefinition/hcpd-amenity","valueCodeableConcept":{"coding":[{"system":"https://healthterminologies.gov.au/fhir/CodeSystem/facility-amenity-1","code":"wheelchairAccess","display":"Wheelchair Access"}]}}],"identifier":[{"type":{"coding":[{"system":"http://terminology.hl7.org.au/CodeSystem/v2-0203","code":"NATAS","display":"NATA Site Number"}],"text":"NATA Site Number"},"system":"http://hl7.org.au/id/nata-site","value":"162899"},{"type":{"coding":[{"system":"http://terminology.hl7.org.au/CodeSystem/v2-0203","code":"LSPN","display":"Location Specific Practice Number"}],"text":"LSPN"},"system":"http://ns.electronichealth.net.au/id/location-specific-practice-number","value":"123333"}],"name":"Physical location at Wynnumwith wheelchair access","alias":["Ye Old Physical location at Wynnum with wheelchair access"],"type":[{"coding":[{"system":"http://terminology.hl7.org/CodeSystem/v3-RoleCode","code":"MOBL","display":"Mobile Unit"},{"system":"http://terminology.hl7.org/CodeSystem/v3-RoleCode","code":"PTRES","display":"Patient's Residence"}]}],"telecom":[{"system":"phone","value":"(02) 1234 5678","use":"work"},{"system":"email","value":"info@location.com.au","use":"work"},{"system":"url","value":"https://www.mocklocation.com.au","use":"work"},{"system":"fax","value":"+61 2 9999 8888","use":"work"}],"address":{"extension":[{"url":"http://hl7.org.au/fhir/StructureDefinition/address-identifier","valueIdentifier":{"type":{"coding":[{"system":"http://terminology.hl7.org.au/CodeSystem/v2-0203","code":"GNAF","display":"Geocoded National Address File Identifier"}],"text":"G-NAF"},"system":"http://hl7.org.au/id/gnafidentifier","value":"GANSW718473771"}}],"type":"physical","text":"123 Bay Terrace Wynnum QLD 4178 Australia","line":["123 Bay Terrace","147-153 Castlereagh Street"],"city":"WYNNUM","state":"QLD","postalCode":"4178","country":"AU"},"position":{"longitude":151.2093,"latitude":-33.8688},"managingOrganization":{"reference":"Organization/example-healthconnect-organization-1"}}

Example of a List resource NDJSON file content that can accompany the export (identifiers for purge):

    {"resourceType":"Parameters","id":"example-hcpd-parameters-1","meta":{"lastUpdated":"2026-03-24T10:30:00+10:00","profile":["http://digitalhealth.gov.au/fhir/hcpd/StructureDefinition/hcpd-parameters"]},"parameter":[{"name":"practitioner","valueIdentifier":{"system":"http://ns.electronichealth.net.au/id/hi/hpii/1.0","value":"8003619900015717"}},{"name":"organization","valueIdentifier":{"system":"http://ns.electronichealth.net.au/id/hi/hpio/1.0","value":"8003626566707032"}},{"name":"practitionerrole","valueIdentifier":{"system":"http://digitalhealth.gov.au/fhir/hcpd/id/hcpd-practitioner-role","value":"pr-54321-example"}},{"name":"healthcareservice","valueIdentifier":{"system":"http://digitalhealth.gov.au/fhir/hcpd/id/hcpd-healthcare-service","value":"hs-67890-example"}},{"name":"location","valueIdentifier":{"system":"http://digitalhealth.gov.au/fhir/hcpd/id/hcpd-location","value":"loc-24680-example"}},{"name":"endpoint","valueIdentifier":{"system":"http://digitalhealth.gov.au/fhir/hcpd/id/hcpd-endpoint","value":"ep-13579-example"}}]}