Connect Provider Search

Patients may not know which system provides their medical data authorization portal. To make this easier, we provide an API endpoint which you can use to query by any search term. The search term can be a doctor's name, clinic, hospital, or address. The query does not have to be an exact match. Therefore, the results will not always be an exact match either. They may contain health systems that the doctor or clinic is not directly affiliated with. Additionally, if the health system that is associated with a doctor is not supported by 1upHealth, it will not be returned in the results. Only hospitals or clinics associated with 1upHealth supported health systems will be returned.

curl -XGET "https://api.1up.health/connect/system/provider/search?q=your+search+query" \
  -H "Authorization: Bearer users_oneup_access_token"

The result will return a bundle of FHIR Organizations which contain the 1upHealth health system id and an extension with the logo of that org or health system. You can use that to direct the patient to the correct connect api url so the patient can authorize sharing of their medical data.

Here's an example result set.

curl -XGET "https://api.1up.health/connect/system/provider/search?q=atul+gawande" \
  -H "Authorization: Bearer users_oneup_access_token"
{
  "resourceType": "Bundle",
  "entry": [
    {
      "resource": {
        "identifier": [
          {
            "system": "https:\/\/nppes.cms.hhs.gov",
            "use": "official",
            "value": "1912335423"
          },
          {
            "system": "https:\/\/1up.health\/dev\/concept\/doc\/1uphealth-system-identifier",
            "use": "official",
            "value": "4774"
          }
        ],
        "extension": [
          {
            "valueUri": "https:\/\/1up.health\/patient\/images\/providers\/brighamwomens.jpg",
            "url": "https:\/\/1up.health\/dev\/concept\/doc\/1uphealth-logo"
          }
        ],
        "address": [
          {
            "country": "US",
            "city": "Boston",
            "use": "work",
            "line": [
              "45 Francis St"
            ],
            "state": "Ma"
          },
          {

          }
        ],
        "meta": {
          "lastUpdated": "2017-11-12T16:25:02.261Z",
          "versionId": "9000000000000"
        },
        "name": "Brigham And Women'S Hospital",
        "active": true,
        "telecom": [
          {
            "system": "phone",
            "use": "work",
            "value": "2165706029"
          },
          {
            "system": "phone",
            "use": "work",
            "value": "6177328613"
          },
          {

          }
        ],
        "id": "1912335423",
        "type": {
          "coding": [
            {
              "code": "282N00000X",
              "system": "http:\/\/nucc.org\/provider-taxonomy",
              "display": "General Acute Care Hospital An acute general hospital is an institution whose primary function is to provide inpatient diagnostic and therapeutic se..."
            }
          ]
        },
        "resourceType": "Organization"
      }
    },
    {
      "resource": {
        "identifier": [
          {
            "system": "https:\/\/nppes.cms.hhs.gov",
            "use": "official",
            "value": "1962837658"
          },
          {
            "value": "4860",
            "use": "official",
            "system": "https:\/\/1up.health\/dev\/concept\/doc\/1uphealth-system-identifier"
          }
        ],
        "address": [
          {
            "country": "US",
            "city": "Cleveland",
            "use": "work",
            "line": [
              "9500 Euclid Ave"
            ],
            "state": "Oh"
          },
          {

          }
        ],
        "meta": {
          "lastUpdated": "2017-11-12T16:16:33.689Z",
          "versionId": "9000000000000"
        },
        "name": "Cleveland Clinic",
        "active": true,
        "telecom": [
          {
            "system": "phone",
            "use": "work",
            "value": "2163014038"
          },
          {
            "system": "phone",
            "use": "work",
            "value": "2164453324"
          },
          {

          }
        ],
        "id": "1962837658",
        "type": {
          "coding": [
            {
              "code": "281P00000X",
              "system": "http:\/\/nucc.org\/provider-taxonomy",
              "display": "Chronic Disease Hospital (1) A hospital including a physical plant and personnel that provides multidisciplinary diagnosis and treatment for dise..."
            }
          ]
        },
        "resourceType": "Organization",
        "extension": [
          {
            "url": "https:\/\/1up.health\/dev\/concept\/doc\/1uphealth-logo",
            "valueUri": "https:\/\/1up.health\/patient\/images\/providers\/cleveland-clinic.png"
          }
        ]
      }
    }
  ]
}