API Reference

Health Gorilla APIs provide access to patient clinical data, documents, diagnostic results, and ordering workflows using the HL7® FHIR® standard. Use the navigation to explore available resources, operations, and platform capabilities.

API Versions

Health Gorilla supports two FHIR-based API versions:

  • FHIR R4 (Recommended): Primary API for new integrations
  • FHIR STU3 (Legacy): Maintained for legacy workflows

If you are starting a new integration, use FHIR R4.

How to Use This Reference

The API Reference is organized by domain and FHIR resource.

  • Platform Foundations: Authentication, errors, async processing, and shared behaviors
  • Patient Clinical Data: Patient records and structured clinical data (e.g., Patient, Observation, Condition)
  • Documents & Results: Clinical documents and reports (e.g., DocumentReference, Binary, DiagnosticReport)
  • Orders & Fulfillment: Ordering workflows and diagnostic services (e.g., ServiceRequest)

Each resource page includes:

  • Overview and common use cases
  • Available endpoints (GET, POST, PUT, DELETE)
  • Supported search parameters
  • Resource-specific behavior and notes

Some resources may include additional operations for extended functionality.

Common Workflows

Developers typically use the API in the following patterns:

  • Retrieve patient data: Patient Clinical Data
  • Work with documents: Documents & Results → DocumentReference → Binary
  • Discover data sources: Documents & Results → Record Locator Service (List)
  • Place and manage orders: Orders & Fulfillment