Getting started

Here for the first time?

Check out these quick start guides:

• How to Create and Publish SMART-on-FHIR apps
• FHIR Authentication and Authorization

📘

FHIR Base URL

Click here for a complete list of customer endpoints.

First steps

Familiarize yourself with this documentation and be sure to sign up in order to be able to deploy your own apps.

If you have a Greenway Identity Services login either as a patient or as an EHR user, you can immediately interact with the API with familiar tools, such as cURL:

curl "https://fhir-api.fhirprod.aws.greenwayhealth.com/fhir/R4/{{TENANT_ID}}"

Authentication and authorization to our FHIR endpoints uses OAuth. Patients and users of our EHR products log in to our production endpoints using their Greenway Identity credentials. A public sandbox will be available soon.

Please refer to our Authentication guide for more information.

Once authenticated, calls to the FHIR API look like this:

curl --request GET \
     --url 'https://fhir-api.fhirstaging.aws.greenwayhealth.com/fhir/R4/\[TENANT_ID\]/Patient/1234' \
     --header 'accept: */*' \
     --header 'authorization: Bearer ThisIsATokenABC123'

import requests

url = "https://fhir-api.fhirstaging.aws.greenwayhealth.com/fhir/R4/[TENANT_ID]/Patient/1234"

headers = {
    "accept": "*/*",
    "authorization": "Bearer ThisIsATokenABC123"
}

response = requests.get(url, headers=headers)

print(response.text)

More background

FHIR, which stands for Fast Healthcare Interoperability Resources, is organized around 'resources' or endpoints that represent the many different data types found in healthcare. Within each resource there are multiple data points. For example, Patient would include details about name, gender, date of birth, marital status, address and so on. The resource names are fairly straightforward.

For more introductory information, see Greenway Health APIs - An Overview