>_ Healix Developer Portal
FHIR API DETAIL

Public Provider Directory

Public Provider Directory (PPD) endpoints using FHIR R4 query semantics. This surface is read-only and exposed at a top-level /pd route.

Version 4.0.1 Updated 2026-04-23 GET only No auth required

Endpoints

MethodPathPurpose
GET/pd/Organization?name={name}Find organizations by name fragment.
GET/pd/Practitioner?name={name}Find practitioners by name.
GET/pd/PractitionerRole?organization={id}Find roles associated with an organization.
GET/pd/Location?organization={id}Find service locations for an organization.
GET/pd/InsurancePlan?name={name}Find plans by name.
GET/pd/HealthcareService?organization={id}Find services for an organization.

Search guidance

  • Public endpoint is read-only and supports GET only.
  • Responses are paged FHIR Bundles. Use _count to tune page size (max 100).
  • Supported public resources: Organization, Practitioner, PractitionerRole, Location, InsurancePlan, HealthcareService, OrganizationAffiliation.
  • Unsupported resources (for example Patient) return OperationOutcome errors.

Sample query

/pd/Practitioner?name=Smith&_count=25

Sorting and paging follow FHIR R4 server capabilities.