Search
K
< Back

Requirements

To launch the SMART on FHIR Patient Chart, your application must support secure OAuth 2.0 authorization and conform to the SMART on FHIR specification. You must also ensure that your tenant, users, and enrolled patients meet the necessary conditions for chart access.

The chart supports both FHIR R4 and STU3, and can be used in embedded or redirect-based workflows depending on your system architecture.

Application-Level Prerequisites

Before launching the chart, ensure your application meets the following requirements:

  • Support SMART on FHIR version 1.0 or later using FHIR R4 or STU3
  • Register your application with Health Gorilla to obtain a client ID, redirect URIs, and, if needed, a client secret
  • Implement OAuth 2.0 Authorization Code Grant flow
  • Include the iss and launch parameters in the authorization request
  • Append context parameters such as patient, encounter, or practitioner based on your workflow
  • Request the following scopes:
    • launch to indicate an EHR-based launch
    • openid and fhirUser to provide user identity context
    • patient/*.* or user/*.* to authorize access to clinical resources
  • Retrieve SMART configuration metadata from https://api.healthgorilla.com/.well-known/smart-configuration

Tenant, User, and Patient Requirements

In addition to application setup, the following access conditions must be met:

  • Your tenant must have Patient Chart access enabled by Health Gorilla Support
  • The user or application role must be authorized to launch the chart
  • The patient must:
    • Be enrolled in your application
    • Have a valid FHIR ID in Health Gorilla
    • Have a completed Patient360 retrieval (if chart data is sourced from P360)

If no data is available for the patient, the chart will display an empty state with guidance.