Provider Search

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 of our traditional API’s, including the Connect Provider Search and System List API. This endpoint provides developers broader search functionality and precise results, which is highly recommended in lieu of the individual API’s.

Search Provider by Name:

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
}

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: support@1up.health