generated: '2026-07-24'
method: derived
source: >-
  collections/nhsd-developers-portal.postman_collection.json + HL7 AU Provider
  Directory (AU-PD) resource model
note: >-
  Entity-relationship graph of the NHSD FHIR resources exposed by the outbound
  API, derived from the official Postman collection's search parameters and the
  AU-PD reference model. Identifiers are FHIR resource ids (UUIDs).
entities:
- name: Organization
  resource: Organization
  id: uuid
  identifiers: [ABN, HPI-O, NHSD organisation identifiers]
  searchable_by: [id, name, identifier, partof]
- name: HealthcareService
  resource: HealthcareService
  id: uuid
  searchable_by: [id, service-type, serviceProvisionCode, openNow, openIn, openAt, characteristic, identifier, location.address-city, location.address-postalcode, location.address-state, location.near, location.near-distance, coverageArea.address-postalcode]
- name: Location
  resource: Location
  id: uuid
  note: Physical (si) or virtual location; carried inline via _include=HealthcareService:location.
- name: PractitionerRole
  resource: PractitionerRole
  id: uuid
  searchable_by: [id, identifier]
- name: Practitioner
  resource: Practitioner
  id: uuid
  identifiers: [AHPRA registration number, Medicare provider number]
  searchable_by: [id, name, identifier]
relationships:
- from: Organization
  to: Organization
  type: belongs_to
  via: partOf
  note: Sub-organisation hierarchy (partof search parameter).
- from: HealthcareService
  to: Organization
  type: belongs_to
  via: providedBy
- from: HealthcareService
  to: Location
  type: has_many
  via: location
- from: PractitionerRole
  to: Practitioner
  type: belongs_to
  via: practitioner
- from: PractitionerRole
  to: Organization
  type: belongs_to
  via: organization
- from: PractitionerRole
  to: HealthcareService
  type: has_many
  via: healthcareService