Provider System Search Guide

1upHealth’s System Search API is a powerful resource enabling 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 developers broader search functionality and precise results, which is highly recommended in lieu of the individual API’s.

Embedding System Search UI with an iframe

1upHealth System Search

The Provider Search UI can be used as an iframe inside an application. Plug your access_token (Check out our Quick Start Guide on how to access tokens) generated with the client_id and client_secret for the application in the provider search url as a query parameter.

<iframe style="border: 0px solid #fff" src="https://system-search.1up.health/search?access_token={YOUR_ACCESS_TOKEN}" height="500" width="100%"/>

After a health system, clinic, hospital or doctor is selected, the user is directed to a quick connect page (using the same access_token) for the login process. Check out our Connect Documentation on how to quick connect.

Search Systems and Providers:

curl -H "Authorization: Bearer {access_token}" -X POST "https://system-search.1up.health/api/search?query=epic&only_health_systems=true" | json_pp

Search Provider Response

{
"value" : [
{
"resource" : {
"active" : true,
"extension" : [
{
"url" : "https://1up.health/dev/concept/doc/1uphealth-logo",
"valueUri" : "https://1up.health/patient/images/providers/epic.jpeg"
},
{
"system" : "https://1up.health/dev/concept/doc/1uphealth-system-api-version",
"value" : "FHIR DSTU2 1.0.2"
},
{
"system" : "https://1up.health/dev/concept/doc/1uphealth-system-ehr-type",
"value" : "Epic"
}
],
"address" : [
{
"line" : [
"",
""
],
"postalCode" : "",
"city" : "Scottsdale",
"state" : "AZ"
}
],
"identifier" : [
{
"system" : "https://1up.health/dev/concept/doc/1uphealth-system-identifier",
"use" : "official",
"value" : 4706
}
],
"name" : "EPIC Medical Center (demo)",
"resourceType" : "Organization"
}
}
],
"key" : 4706
}

Provider Search API

The Provider Search API can be used to make custom provider search interface for patients or retrieve results returned by the above iframe. Plug your access_token (Check out our Quick Start Guide on how to get access tokens) generated with the client_id and client_secret for the application in the header as a Bearer Token and search term as a query parameter in the url.

curl -X POST "https://system-search.1up.health/api/search?query={SEARCH-TERM}" \
-H "Authorization: Bearer {YOUR_ACCESS_TOKEN}"

Result is a list of health systems, clinics, hospitals or doctors for the searched term with 1upHealth system id which can be used to direct a user to a quick connect page or a patient portal (using the same access token) to initiate the login process. Check out our Connect Documentation on how to quick connect.

This API can also be used to search by the health system id using the id search parameter:

curl -X POST "https://system-search.1up.health/api/search?id={system_id}" \
-H "Authorization: Bearer {YOUR_ACCESS_TOKEN}"

Questions?

Reach out to our engineering team at: [email protected]