Provider Search UI and API

The Provider Search UI is a feature that can incorporate the unified single search function into your application. The search bar will display the searched items in bold and similar items will display for additional suggestions.

The Provider Search UI utilizes individual end points we have created to easily access specific data sets.


Search by Hospital Name

Patients can search by the name of a health system, facility or clinic to identify where their data resides.

Search by Hospital/Provider Address

If individuals do not know the name of the organization, they can also search by the address, city, and / or state.

Search by Doctor Name

Commonly patients only know their Doctor's name. The Provider Search UI makes it easy to search by a name and find the associated health system.

Search Bar Capabilities

The Provider Search accepts the search parameters listed below:

Hospital/Provider Doctor
Name Name
Address Address
City City
State State
Clinic Within Hospital NPI Number

Embedding with an iframe

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 applicaton 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 Quick Connect Documentation on how to quick connect.

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 applicaton in the header as a Bearer Token and search term as a query parameter in the url.

  

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

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

Questions?

Reach out to our engineering team at: eng@1up.health