Retrieval Overview

Record Retrieval enables discovery and retrieval of patient data from Health Gorilla’s network of clinical sources. Includes structured clinical data, documents, diagnostic results, and information about where data originated.

How Record Retrieval Works

Record retrieval typically involves multiple steps:

1. Identify the patient
2. Discover where data exists
3. Retrieve metadata about available records
4. Retrieve the underlying data or documents

Different resources and capabilities support each step.

Retrieval Capabilities

The following capabilities support patient data retrieval:

• Patient Clinical Data: Retrieve structured clinical data such as demographics, conditions, and observations
• Documents & Results: Retrieve document metadata and diagnostic reports using DocumentReference and DiagnosticReport
• Binary: Download document content (PDF, CDA, images) referenced by document resources
• Record Locator Service (List): Discover which organizations and providers have data for a patient
• Provenance: Identify the source and origin of clinical data

Typical Retrieval Flow

A common retrieval workflow:

1. Retrieve or identify a patient using Patient
2. Discover data sources using Record Locator Service (List)
3. Retrieve available documents using DocumentReference
4. Download document content using Binary
5. Review source information using Provenance

Related Sections

Record Retrieval spans multiple sections of the API Reference:

Patient Clinical Data: Core patient records and structured data

Documents & Results: Clinical documents and diagnostic reports

Events & Delivery: Notifications and asynchronous delivery of retrieved data