Source Categorization and Deduplication

Source Categorization and Deduplication uses your organization's local data to deduplicate against external data at the point of consumption, classifying records by source as Internal, External, or Internal + External. The result is a single, deduplicated patient view: clinicians see external data they did not already have, with duplicates resolved by reference to your local system.

When a chart is read, Health Gorilla compares records found in external networks against records that already exist in your local system. External records that duplicate a local record are suppressed, and records that exist in both sources appear once, marked as belonging to both.

Source Categorization and Deduplication operates at view time. It does not modify source data, does not run during ingestion, and does not affect what Patient360 stores in your tenant.

How Records Are Classified

Each record in the Patient Chart and chart APIs is classified by source:

Display Behavior

The Patient Chart applies these display rules:

• Internal-only records are not displayed. They remain in your local system and are not added to the Patient Chart view.
• External-only records are displayed. They are marked with a Community Data icon (hover label: Community data (external sources)).
• Internal + External records are displayed once. They appear under the combined Internal + External category instead of separately under Internal and External.

API Behavior

Patient Chart API responses include a resourceChannelType field on each record, with values INTERNAL, EXTERNAL, or BOTH. This field replaces the legacy internalDataOrigin boolean.

Example response (excerpt):

{
  "id": "abc123",
  "resourceChannelType": "BOTH",
  ...
}

Patient Chart API endpoints accept an optional resourceChannelTypes array parameter that filters results by source. The default filter is [EXTERNAL, BOTH], which excludes INTERNAL records by default.

To override the default and return all three classifications, include all three values on that parameter.

POST /rest/patient-chart/v1/allergies/patients/{globalId}/search
Content-Type: application/json

{
  "resourceChannelTypes": ["INTERNAL", "EXTERNAL", "BOTH"]
}

This filtering applies across the following Patient Chart record categories:

• Advance Directives
• Allergies
• Diagnoses
• Documents
• Encounters
• Family History
• Functional Status
• Immunizations
• Labs and Imaging
• Medical Equipment
• Medications
• Miscellaneous
• Procedures
• Social History
• Treatment Plan
• Vital Signs

Enabling This Feature

Source Categorization and Deduplication is opt-in and is not enabled by default. To enable it for your tenant, contact Health Gorilla. Health Gorilla configures the feature on your behalf; no integration changes are required after enablement. Once enabled, the behavior applies automatically to the Patient Chart and chart APIs.