Chart Bridge

Overview

Chart Bridge enables developers to retrieve medical records for insurance purposes from data networks. This guide provides detailed instructions on how to use our API to search for patient records and retrieve clinical records from the Chart Bridge data source.

The Chart Bridge API is part of Health Gorilla's RESTful API suite and is based on HL7 FHIR STU3 and R4.

References

HL7 FHIR

Health Gorilla RESTful API is based on FHIR protocol version 3 and 4. Some custom resource profiles are defined and extension mechanisms are used to introduce new attributes and operations that are absent in the original protocol.

Access Control

Health Gorilla implements SMART-on-FHIR profile and uses OAuth 2.0 framework for authentication and authorization. You need to obtain an access token and include it into the request to access the desired API endpoint.

user/*.*

High Level Workflow

721721

Chart Bridge flow diagram for querying records.

Select patient

To query records in the Chart Bridge network, the patient record must first exist in Health Gorilla.

See the FHIR Patient APIs section on how to create or search for a patient to determine the Patient Resource ID.

More patient information provided can dramatically increase the number of documents returned.

Field

Required/Recommended

Notes

given

Required

Patient given name

family

Required

Patient family name

birthdate

Required

gender

Required

address

Required

Postal code OR city/state required, but full address recommended

Including multiple addresses can increase number of documents retrieved

phone number

Recommended

  • telecom in FHIR Patient

email

Recommended

  • telecom in FHIR Patient

Select Consent

To query records in the Chart Bridge network, the patient authorization/consent forms must first exist in Health Gorilla.

See the FHIR Patient Consent APIs section on how to create or search a Patient Consent ID.

Create

HTTP Request

Method

Action

/Consent

POST

Creates Consent resource

The following attributes are required:

Name

Details

patient

source

actor

Query Using Chart Bridge

Health Gorilla connects to multiple networks and the $init-chartbridge-enrollment endpoint queries all networks from a single call based on your permitted purposes and licensing.

Parameters:

Name

Value

Description

patient

RESOURCE_ID

The patient resourced ID. Mandatory.

consent

RESOURCE_ID

The consent authorization resource ID. Mandatory

Example:

Query for the person's details matching the given patient id and consent forms.

https://api.healthgorilla.com/fhir/Patient/{patientID value}/$init-chartbridge-enrollment?consent={value}

Response:

The operation returns an identifier for the request.

{
    "resourceType": "OperationOutcome",
    "id": "7fcfde623d78bb6bf6b99063"
}

After a successful query is created, the user will now be able to retrieve the documents as soon as 5 minutes but some requests may take up to 5 days.