Links
Comment on page

Provider System Search Guide

1upHealth’s System Search API is a powerful resource that enables developers to leverage each provider search API in a single query. The System Search API search parameters match against the name attribute, address.line, or address.city of our traditional API’s, including the Connect Provider Search and System List API. This endpoint and the UI give you broader search functionality and precise results, which we recommend instead of the individual APIs.

Embed the System Search UI in an Iframe

1upHealth System Search
You can embed the Provider Search UI in an iframe inside an application.
Specify the following URL for the iframe:
<iframe style="border: 0px solid #fff" src="https://system-search.1up.health/search?access_token={YOUR_ACCESS_TOKEN}" height="500" width="100%"/>
Make sure to add your access_token generated with the client_id and client_secret for the application in the provider search URL as a query parameter. For information about access tokens, see the Quick Start Guide.
After a health system, clinic, hospital, or doctor is selected, the user is directed to a quick connect page (using the same access_token) to log in.
For information about the quick connect process, see the Connect Documentation.

Search Systems and Providers

To search for health systems and providers, run the following curl command.
curl -H "Authorization: Bearer {access_token}" -X POST "https://system-search.1up.health/api/search?query=epic&offset=20" | json_pp

Search Provider Response

The following is an example response from a health system and provider search.
[
{
"id": 4894,
"name": "Michigan Medicine",
"address": "1500 E Medical Center Dr",
"fhirVersion": "FHIR R4",
"ehr": "epic",
"resourceUrl": "https://mcproxyprd.med.umich.edu/FHIR-PRD/api/FHIR/DSTU2",
"logo": "https://1uphealth-assets.s3-us-west-2.amazonaws.com/systems/michigan-medicine.png",
}
]

Provider Search API

You can use the Provider Search API to create a custom provider search interface for patients, or to retrieve results returned by the System Search UI. ]
Add your access_token generated with the client_id and client_secret for the application to the header as a Bearer Token and the search term as a query parameter in the URL.
curl -X POST "https://system-search.1up.health/api/search?query={SEARCH-TERM}&offset=20" \
-H "Authorization: Bearer {YOUR_ACCESS_TOKEN}"
For information about access tokens, see the Quick Start Guide.
After you run this query, the result is a list of health systems, clinics, hospitals, or doctors for the searched term with the 1upHealth system ID. You can use this ID to direct a user to a quick connect page or a patient portal (using the same access token) to initiate the login process.
Each search returns 20 rows at a time with the offset value as the starting point.
For information about the quick connect process, see the Connect Documentation.

Questions?

For more information or to get help with your questions, contact the 1upHealth Support team.