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.

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. 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
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",
}
]
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}"
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. Last modified 5mo ago