Patient Connect APIs
You can use the 1up FHIR API and 1up Connect API to connect to individual patient records and get patient consent through the patient’s health system’s patient portal. After patients have authorized sharing their data and the data is ingested in the 1up FHIR Server, you can use the Patient Connect and FHIR APIs to retrieve that patient data.
API Reference for Patient Connect
After patients authorize access to their data, you can use the access token and the 1up FHIR API to get the FHIR® resources for that patient. You can also use the 1up Connect API endpoint to get a list of supported health plans and health systems.
![Closed](../../../Skins/Default/Stylesheets/Images/transparent.gif)
GET https://api.1up.health/dstu2/Patient?query-param=queryvalue
Use this 1up FHIR API endpoint to get access to the Patient resource.
Parameters
Query | ||
---|---|---|
query-param | string | The query string value. |
Header | ||
---|---|---|
Authorization | string | This endpoint receives authentication requests as an HTTP authentication header with a Bearer token. |
Responses
200 |
![]()
|
![Closed](../../../Skins/Default/Stylesheets/Images/transparent.gif)
POST https://api.1up.health/connect/system/clinical
Use the 1up Connect API endpoint to query the full list of supported health plans and health systems.
If you need a full-text search of providers for fields such as name, address, or clinician names, we recommend using the System Search endpoint instead.
Parameters
Header | ||
---|---|---|
JSON object |
Body | ||
---|---|---|
JSON object | ||
client_id |
string |
API key generated for your application. |
client_secret |
string |
API key generated for your application. |
systemType |
string |
The type of system. Example — Health System or Payer Patient Access |
Responses
200: OK |
![]()
|
Use the 1up APIs for Patient Connect
1upHealth allows users to connect data within health system (providers) electronic health records (EHR). As a developer, you can read your users' clinical health data from patients who are using your app.
Data from external health systems is a vital, missing piece that's required to improve care and reduce costs. Data from other clinics and hospitals can fill this gap.
To get OAuth client keys for the 1upHealth API, you can create an account.
Patient Connect Process Overview
-
Your app must direct users to the 1upHealth Connect API URL to link to a specific health system.
-
Users will see the systems authentication screen and can then allow access to their data.
-
User are redirected back to your app's
redirect_uri
. 1upHealth retrieves data from that system into the 1up FHIR Server. -
Your app can query that user's resources, which are stored in FHIR® format on the 1up FHIR Server.
Get a List of Supported Health Plans & Health Systems
1upHealth supports hundreds of health plans and health systems. You can get the full list by querying the following endpoint. Results are returned in increments of 20, in alphabetical order.
The request response includes the IDs of each health system that matches your search query. The following is an example of a single entry from a response.
![Closed](../../../Skins/Default/Stylesheets/Images/transparent.gif)
[
{
"address" : "450 4th Ave Chula Vista CA 91910",
"ehr" : "eClinicalWorks",
"fhirVersion" : "FHIR STU3 3.0.1",
"id" : 11207,
"logo" : "https://1uphealth-assets.s3-us-west-2.amazonaws.com/systems/health-system-default.png",
"name" : "Absolute Foot Care",
"resourceUrl" : "https://fhir.healow.com/FHIRServer/fhir/CDJDCA"
},
{
"address" : "540 2nd Ave S Saint Petersburg FL 33701",
"ehr" : "eClinicalWorks",
"fhirVersion" : "FHIR STU3 3.0.1",
"id" : 11208,
"logo" : "https://1uphealth-assets.s3-us-west-2.amazonaws.com/systems/health-system-default.png",
"name" : "Absolute Health Internal Med and Peds Ocala FL",
"resourceUrl" : "https://fhir.healow.com/FHIRServer/fhir/CIEABD"
},
]
You can use the ID from the response in other requests to the FHIR Server. In this example, the IDs are 11207 and 11208.
Connect Users
Before you can connect users to their health systems, you must use the 1up User Management API to create a user. Application developers that want to programmatically direct users to connect their health systems must send users to the following URL.
If you include the fhirVersion
parameter, only valid FHIR versions supported by that system will retrieve FHIR resources.
When a user follows the link to the URL you specified, the following process occurs.
-
1upHealth redirects the user to the OAuth2 authorization page for the clinical system.
-
The user enters credentials for the health system.
To test the process, you can use 1up's test credentials for health systems that use FHIR.
-
1upHealth receives an access token for that user, and directs the user back to your app's
redirect_uri
(which is associated with theclient_id
). -
1upHealth begins collecting data in the 1up FHIR Server and makes it available to your application.
Access the Connected Data
After users have authorized sharing their data, and their clinical and claims data is sent to the 1up FHIR Server through the 1up FHIR® API, the data is stored as native FHIR® resources. Apps can get access to the clinical and claims data for a specific user by including an authorization Bearer token (access_token
) for that user in the request to the 1up FHIR Server. You can modify the query from your app to select which source metrics you want to get data from.
The following are a few examples of app queries. Each query must be accompanied by the Authorization header that contains the user's authorization Bearer token.
![Closed](../../../Skins/Default/Stylesheets/Images/transparent.gif)
To run a query for a specific user, you can use that user's access_token
.
You can run a query to get new clinical data using the same access token, or a new access token if the original token expired.
Get Specific Patient Data
You can use the 1upHealth FHIR API $everything
query to get the full patient history or to query for specific FHIR resources.
For more information, see Get Patient Data.