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.

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.

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.

  1. 1upHealth redirects the user to the OAuth2 authorization page for the clinical system.

  2. 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.

  3. 1upHealth receives an access token for that user, and directs the user back to your app's redirect_uri (which is associated with the client_id).

  4. 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.

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.