HL7 FHIR R4 Support

clearPath exposes hand-hygiene compliance events and custom audit definitions as standard HL7 FHIR R4 resources under /api/v1/fhir/*. The surface conforms to the FHIR R4 resource model (fhirVersion 4.0.1) and is intended for server-to-server integrations with analytics platforms, EHRs, and reporting systems that speak FHIR natively.

All responses are served as application/fhir+json. Search results are returned as FHIR Bundle resources of type searchset, and errors are returned as FHIR OperationOutcome resources — exactly what your downstream systems already expect.

Request a Quote Compare Editions

Key Benefits

  • FHIR R4 compliant (4.0.1)
  • Standard application/fhir+json
  • Bundle searchsets and OperationOutcomes
  • Token-scoped per account
  • LOINC-coded hand hygiene observations
  • Read and create QuestionnaireResponse
  • Anonymous CapabilityStatement at /fhir/metadata
  • Built for server-to-server integration

Supported Resources

clearPath publishes four FHIR resource types out of the box, each mapped to the closest semantic match in the clearPath data model. Hand-hygiene events become Observation resources, rolled-up compliance becomes MeasureReport, custom audits become Questionnaire definitions, and submitted responses become QuestionnaireResponse entries.

  • Observation — one resource per observed hand-hygiene moment, coded with LOINC 54564-0 ("Hand hygiene observation"). The valueCodeableConcept field carries the compliant / non-compliant result.
  • MeasureReport — rolled-up compliance rates across a date window, scoped to a facility or to the whole account.
  • Questionnaire — clearPath custom audit definitions, exposed as standard FHIR Questionnaires for downstream systems that already render Questionnaires.
  • QuestionnaireResponse — read submitted responses, or POST a new one from a FHIR-aware client.

Authentication & Tokens

FHIR endpoints are protected by a per-account API token sent in the X-API-Token header. Tokens are managed through the standard clearPath user editor, can be rotated at any time, and are scoped to a single corporation — so a partner system can read from one account without ever seeing data from another.

  • Per-account X-API-Token header
  • Anonymous /fhir/metadata for capability discovery
  • Tokens rotate without downtime
  • Cross-tenant isolation enforced server-side
  • Standard FHIR query parameters: subject, date-from, date-to, _count, _offset
  • ge / le / eq / gt / lt date prefixes accepted

Speak FHIR. Skip the Custom Adapter.

HL7 FHIR R4 support is included with the Ultimate edition. Wire clearPath into your EHR, your analytics warehouse, or any FHIR-aware reporting system without writing a custom data extract.

Request a Quote Compare Editions