FHIR

Fast Healthcare Interoperability Resources (FHIR) is a healthcare standard for representing and exchanging electronic medical information.

See the following FHIR specifications for more details about FHIR:

FHIR stores

A FHIR store is a data store in the Cloud Healthcare API that holds FHIR resources. FHIR stores exist inside datasets.

The FhirStore resource provides a representation of a FHIR store's attributes. For each FHIR store, you can choose options such as:

The state of these configuration options is shown in the FHIR store's capability statement (STU3 or R4) or conformance statement (DSTU2).

FHIR resources

FHIR specifies a base set of resources that can be combined in various ways to meet the data model demands of healthcare providers. It also provides representations of clinical observations and documents. FHIR does not aim to encompass every possible document or data type; rather, FHIR first provides support for most clinical and billing use cases. You can then extend your FHIR implementation to meet additional clinical or organizational needs.

The Cloud Healthcare API’s FHIR implementation provides full support for FHIR DSTU2, STU3, and R4 resources.

FHIR base URL implementation

As shown in the official FHIR documentation (DSTU2, STU3, and R4), a FHIR Service Base URL uses the format http(s)://server/PATH. For example, https://server/path/Observation.

The Cloud Healthcare API uses a base URL that aligns with this standard. The Cloud Healthcare API base URL contains the following parts:

  • The endpoint for the Cloud Healthcare API
  • The version of the Cloud Healthcare API
  • The project ID
  • The name of a dataset
  • The dataset's location
  • The name of a FHIR store
  • The /fhir suffix

The following table shows the format of a FHIR Service Base URL and its equivalent base URL in the Cloud Healthcare API:

FHIR Service Base URLCloud Healthcare API equivalent URL
http(s)://server/PATH https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir

To get information about a patient using the FHIR RESTful API, make an HTTP GET request. The following table shows the format to use to get this information using the FHIR Service Base URL and its equivalent base URL in the Cloud Healthcare API:

FHIR Service Base URLCloud Healthcare API equivalent URL
http(s)://server/path/Patient/PATIENT_ID https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/PATIENT_ID

FHIR conformance

See the FHIR conformance statement for information on the FHIR DSTU2, STU3, and R4 implementations in the Cloud Healthcare API.