Public Data

Making the most of health data requires an existing base of information connected to that health data. For example, knowing the NPI number a patient saw is great, but knowing the specialization of the doctor associated with that NPI is even better. Similarly seeing an NDC code show up in a medications list is not helpful without knowing the actual name of that medication and the packaging dosage. For this reason, we provide a FHIR® API with much of this information already populated.

DSTU2 Public Data

To query any open data just append _public=true parameter to any FHIR® endpoint. Like any other request against our platform, you must have a valid access_token to query our public data. The following is an example of how you could find a list of all the public doctors (FHIR® provider) on 1upHealth.

curl -XGET 'https://api.1up.health/dstu2/Practitioner?_public=true' \
  -H 'Authorization: Bearer access_token'

GET  https://api.1up.health/dstu2/Practitioner?_public=true

Use this endpoint to get Practitioners.

Parameters

Query    

Authorization

string

OAuth 2.0 Access token required in header.

Responses

200 
{
   "entry" : [
      {
         "search" : {
            "mode" : "match"
         },
         "fullUrl" : "https://api.1up.health/dstu2/Practitioner/06eec62d8034",
         "resource" : {
            "address" : [
               {
                  "country" : "US",
                  "city" : "Boston",
                  "use" : "work",
                  "state" : "Ma"
               }
            ],
            "meta" : {
               "lastUpdated" : "2020-10-28T22:20:19.532Z",
               "versionId" : "9000000000000"
            },
            "resourceType" : "Practitioner",
            "name" : {
               "given" : [
                  "Atul"
               ],
               "suffix" : [
                  "MD"
               ],
               "use" : "official",
               "family" : [
                  "Gawande"
               ]
            },
            "gender" : "male",
            "id" : "06eec62d8034"
         }
      },
      {
         "resource" : {
            "address" : [
               {
                  "country" : "US",
                  "city" : "Andover",
                  "use" : "work",
                  "state" : "Oh",
                  "line" : [
                     "10 Public Square"
                  ]
               }
            ],
            "practitionerRole" : [
               {
                  "specialty" : [
                     {
                        "coding" : [
                           {
                              "code" : "225X00000X",
                              "display" : "An occupational therapist is a person who has graduated from an entry-level occupational therapy program accredited by t...",
                              "system" : "http://nucc.org/provider-taxonomy"
                           }
                        ]
                     }
                  ],
                  "role" : {
                     "coding" : [
                        {
                           "code" : "225X00000X",
                           "display" : "Occupational Therapist",
                           "system" : "http://nucc.org/provider-taxonomy"
                        }
                     ]
                  }
               }
            ],
            "meta" : {
               "lastUpdated" : "2020-10-05T01:23:17.884Z",
               "versionId" : "9000000000000"
            },
            "name" : {
               "given" : [
                  "Louise",
                  "V"
               ],
               "suffix" : [
                  "OTR/L"
               ],
               "use" : "official",
               "family" : [
                  "Sheridan"
               ]
            },
            "resourceType" : "Practitioner",
            "active" : true,
            "identifier" : [
               {
                  "value" : "SH4046472",
                  "use" : "official",
                  "system" : "Medicare ID-Type Unspecified OH"
               },
               {
                  "system" : "https://nppes.cms.hhs.gov",
                  "use" : "official",
                  "value" : "1699702266"
               },
               {
                  "value" : "kjsdbchadsbhabdjvhbjhvf",
                  "use" : "usual",
                  "system" : "https://open-ic.epic.com/FHIR/api/FHIR/DSTU2"
               }
            ],
            "telecom" : [
               {
                  "system" : "fax",
                  "use" : "work",
                  "value" : "4402934670"
               },
               {
                  "use" : "work",
                  "system" : "phone",
                  "value" : "4402934420"
               }
            ],
            "id" : "0a73cf642dc9",
            "gender" : "female"
         },
         "fullUrl" : "https://api.1up.health/dstu2/Practitioner/0a73cf642dc9",
         "search" : {
            "mode" : "match"
         }
      },
      {
         "fullUrl" : "https://api.1up.health/dstu2/Practitioner/1003000100",
         "resource" : {
            "active" : true,
            "telecom" : [
               {
                  "system" : "fax",
                  "use" : "work",
                  "value" : "2133831280"
               },
               {
                  "value" : "2133657400",
                  "use" : "work",
                  "system" : "phone"
               },
               {}
            ],
            "identifier" : [
               {
                  "value" : "1003000100",
                  "use" : "official",
                  "system" : "https://nppes.cms.hhs.gov"
               },
               {}
            ],
            "id" : "1003000100",
            "gender" : "male",
            "meta" : {
               "lastUpdated" : "2017-11-13T01:11:52.199Z",
               "versionId" : "9000000000000"
            },
            "practitionerRole" : [
               {
                  "role" : {
                     "coding" : [
                        {
                           "code" : "171M00000X",
                           "display" : "Case Manager/Care Coordinator",
                           "system" : "http://nucc.org/provider-taxonomy"
                        }
                     ]
                  },
                  "specialty" : [
                     {
                        "coding" : [
                           {
                              "system" : "http://nucc.org/provider-taxonomy",
                              "code" : "171M00000X",
                              "display" : "A person who provides case management services and assists an individual in gaining access to needed medical, social, ed..."
                           }
                        ]
                     }
                  ]
               }
            ],
            "address" : [
               {
                  "use" : "work",
                  "state" : "Ca",
                  "line" : [
                     "680 S Wilton Pl"
                  ],
                  "city" : "Los Angeles",
                  "country" : "US"
               },
               {}
            ],
            "name" : {
               "given" : [
                  "Gerardo"
               ],
               "use" : "official",
               "family" : [
                  "Gomez"
               ]
            },
            "resourceType" : "Practitioner"
         },
         "search" : {
            "mode" : "match"
         }
      },
      {
         "resource" : {
            "telecom" : [
               {
                  "value" : "3017234000",
                  "use" : "work",
                  "system" : "phone"
               },
               {
                  "value" : "4436026207",
                  "system" : "phone",
                  "use" : "work"
               },
               {}
            ],
            "identifier" : [
               {
                  "value" : "1003000126",
                  "use" : "official",
                  "system" : "https://nppes.cms.hhs.gov"
               },
               {}
            ],
            "active" : true,
            "gender" : "male",
            "id" : "1003000126",
            "meta" : {
               "versionId" : "9000000000000",
               "lastUpdated" : "2017-11-13T01:12:01.187Z"
            },
            "address" : [
               {
                  "country" : "US",
                  "city" : "Cumberland",
                  "line" : [
                     "900 Seton Dr"
                  ],
                  "state" : "Md",
                  "use" : "work"
               },
               {}
            ],
            "practitionerRole" : [
               {
                  "specialty" : [
                     {
                        "coding" : [
                           {
                              "display" : "A physician who provides long-term, comprehensive care in the office and the hospital, managing both common and complex ...",
                              "code" : "207R00000X",
                              "system" : "http://nucc.org/provider-taxonomy"
                           }
                        ]
                     }
                  ],
                  "role" : {
                     "coding" : [
                        {
                           "display" : "Internal Medicine",
                           "code" : "207R00000X",
                           "system" : "http://nucc.org/provider-taxonomy"
                        }
                     ]
                  }
               }
            ],
            "name" : {
               "use" : "official",
               "family" : [
                  "Enkeshafi"
               ],
               "given" : [
                  "Ardalan"
               ],
               "suffix" : [
                  "M.D."
               ]
            },
            "resourceType" : "Practitioner"
         },
         "fullUrl" : "https://api.1up.health/dstu2/Practitioner/1003000126",
         "search" : {
            "mode" : "match"
         }
      },
      {
         "fullUrl" : "https://api.1up.health/dstu2/Practitioner/1003000134",
         "resource" : {
            "practitionerRole" : [
               {
                  "role" : {
                     "coding" : [
                        {
                           "display" : "Pathology",
                           "code" : "207ZP0102X",
                           "system" : "http://nucc.org/provider-taxonomy"
                        }
                     ]
                  },
                  "specialty" : [
                     {
                        "coding" : [
                           {
                              "code" : "207ZP0102X",
                              "display" : "Anatomic Pathology & Clinical Pathology, A pathologist deals with the causes and nature of disease and contributes to di...",
                              "system" : "http://nucc.org/provider-taxonomy"
                           }
                        ]
                     }
                  ]
               }
            ],
            "address" : [
               {
                  "use" : "work",
                  "state" : "Il",
                  "line" : [
                     "2650 Ridge Ave",
                     "EVANSTON HOSPITAL"
                  ],
                  "city" : "Evanston",
                  "country" : "US"
               },
               {}
            ],
            "meta" : {
               "lastUpdated" : "2017-11-13T01:11:54.571Z",
               "versionId" : "9000000000000"
            },
            "name" : {
               "family" : [
                  "Cibull"
               ],
               "use" : "official",
               "suffix" : [
                  "M.D."
               ],
               "given" : [
                  "Thomas",
                  "Lee"
               ]
            },
            "resourceType" : "Practitioner",
            "active" : true,
            "telecom" : [
               {
                  "system" : "fax",
                  "use" : "work",
                  "value" : "8477335315"
               },
               {
                  "use" : "work",
                  "system" : "phone",
                  "value" : "8475702040"
               },
               {}
            ],
            "identifier" : [
               {
                  "system" : "https://nppes.cms.hhs.gov",
                  "use" : "official",
                  "value" : "1003000134"
               },
               {}
            ],
            "id" : "1003000134",
            "gender" : "male"
         },
         "search" : {
            "mode" : "match"
         }
      },
      {
         "search" : {
            "mode" : "match"
         },
         "fullUrl" : "https://api.1up.health/dstu2/Practitioner/1003000142",
         "resource" : {
            "identifier" : [
               {
                  "value" : "0051712",
                  "use" : "official",
                  "system" : "Medicaid OH"
               },
               {
                  "system" : "Medicare PIN OH",
                  "use" : "official",
                  "value" : "H007320"
               },
               {
                  "use" : "official",
                  "system" : "https://nppes.cms.hhs.gov",
                  "value" : "1003000142"
               },
               {}
            ],
            "telecom" : [
               {
                  "system" : "fax",
                  "use" : "work",
                  "value" : "4195177656"
               },
               {
                  "system" : "phone",
                  "use" : "work",
                  "value" : "4195177624"
               },
               {}
            ],
            "active" : true,
            "id" : "1003000142",
            "gender" : "male",
            "practitionerRole" : [
               {
                  "role" : {
                     "coding" : [
                        {
                           "code" : "207L00000X",
                           "display" : "Anesthesiology",
                           "system" : "http://nucc.org/provider-taxonomy"
                        }
                     ]
                  },
                  "specialty" : [
                     {
                        "coding" : [
                           {
                              "system" : "http://nucc.org/provider-taxonomy",
                              "code" : "207L00000X",
                              "display" : "An anesthesiologist is trained to provide pain relief and maintenance, or restoration, of a stable condition during and ..."
                           }
                        ]
                     }
                  ]
               },
               {
                  "role" : {
                     "coding" : [
                        {
                           "display" : "Anesthesiology",
                           "code" : "207LP2900X",
                           "system" : "http://nucc.org/provider-taxonomy"
                        }
                     ]
                  },
                  "specialty" : [
                     {
                        "coding" : [
                           {
                              "system" : "http://nucc.org/provider-taxonomy",
                              "display" : "Pain Medicine, An anesthesiologist who provides a high level of care, either as a primary physician or consultant, for p...",
                              "code" : "207LP2900X"
                           }
                        ]
                     }
                  ]
               }
            ],
            "address" : [
               {
                  "country" : "US",
                  "city" : "Toledo",
                  "use" : "work",
                  "state" : "Oh",
                  "line" : [
                     "4126 N Holland Sylvania Rd",
                     "SUITE 220"
                  ]
               },
               {}
            ],
            "meta" : {
               "lastUpdated" : "2017-11-13T01:11:53.045Z",
               "versionId" : "9000000000000"
            },
            "resourceType" : "Practitioner",
            "name" : {
               "family" : [
                  "Khalil"
               ],
               "use" : "official",
               "given" : [
                  "Rashid"
               ],
               "suffix" : [
                  "M.D."
               ]
            }
         }
      },
      {
         "search" : {
            "mode" : "match"
         },
         "fullUrl" : "https://api.1up.health/dstu2/Practitioner/1003000159",
         "resource" : {
            "telecom" : [
               {
                  "use" : "work",
                  "system" : "fax",
                  "value" : "8435543356"
               },
               {
                  "value" : "8435546737",
                  "system" : "phone",
                  "use" : "work"
               },
               {}
            ],
            "identifier" : [
               {
                  "value" : "P099269295",
                  "system" : "MEDICARE PTAN Other SC",
                  "use" : "official"
               },
               {
                  "system" : "Medicaid SC",
                  "use" : "official",
                  "value" : "NP0404"
               },
               {
                  "use" : "official",
                  "system" : "Medicare PIN SC",
                  "value" : "9295"
               },
               {
                  "use" : "official",
                  "system" : "Medicare PIN SC",
                  "value" : "P099265277"
               },
               {
                  "use" : "official",
                  "system" : "Medicare UPIN SC",
                  "value" : "P099269295"
               },
               {
                  "value" : "1003000159",
                  "use" : "official",
                  "system" : "https://nppes.cms.hhs.gov"
               },
               {}
            ],
            "active" : true,
            "id" : "1003000159",
            "gender" : "female",
            "practitionerRole" : [
               {
                  "specialty" : [
                     {
                        "coding" : [
                           {
                              "system" : "http://nucc.org/provider-taxonomy",
                              "display" : "Family",
                              "code" : "363LF0000X"
                           }
                        ]
                     }
                  ],
                  "role" : {
                     "coding" : [
                        {
                           "code" : "363LF0000X",
                           "display" : "Nurse Practitioner",
                           "system" : "http://nucc.org/provider-taxonomy"
                        }
                     ]
                  }
               }
            ],
            "address" : [
               {
                  "use" : "work",
                  "state" : "Sc",
                  "line" : [
                     "4115 Dorchester Road",
                     "CONCENTRA MEDICAL CENTER"
                  ],
                  "city" : "Charleston",
                  "country" : "US"
               },
               {}
            ],
            "meta" : {
               "lastUpdated" : "2017-11-13T01:11:54.988Z",
               "versionId" : "9000000000000"
            },
            "resourceType" : "Practitioner",
            "name" : {
               "family" : [
                  "Voges"
               ],
               "use" : "official",
               "suffix" : [
                  "FNP"
               ],
               "given" : [
                  "Marsha",
                  "Susan"
               ]
            }
         }
      },
      {
         "search" : {
            "mode" : "match"
         },
         "resource" : {
            "identifier" : [
               {
                  "value" : "1003000167",
                  "use" : "official",
                  "system" : "https://nppes.cms.hhs.gov"
               },
               {}
            ],
            "telecom" : [
               {
                  "value" : "7752207788",
                  "use" : "work",
                  "system" : "phone"
               },
               {}
            ],
            "active" : true,
            "gender" : "male",
            "id" : "1003000167",
            "practitionerRole" : [
               {
                  "role" : {
                     "coding" : [
                        {
                           "system" : "http://nucc.org/provider-taxonomy",
                           "display" : "Dentist",
                           "code" : "122300000X"
                        }
                     ]
                  },
                  "specialty" : [
                     {
                        "coding" : [
                           {
                              "system" : "http://nucc.org/provider-taxonomy",
                              "code" : "122300000X",
                              "display" : "A dentist is a person qualified by a doctorate in dental surgery (D.D.S.) or dental medicine (D.M.D.), licensed by the s..."
                           }
                        ]
                     }
                  ]
               }
            ],
            "address" : [
               {
                  "line" : [
                     "5 Pine Cone Rd"
                  ],
                  "state" : "Nv",
                  "use" : "work",
                  "city" : "Dayton",
                  "country" : "US"
               },
               {}
            ],
            "meta" : {
               "lastUpdated" : "2017-11-13T01:11:53.322Z",
               "versionId" : "9000000000000"
            },
            "resourceType" : "Practitioner",
            "name" : {
               "suffix" : [
                  "DDS"
               ],
               "given" : [
                  "Julio",
                  "Edgardo"
               ],
               "family" : [
                  "Escobar"
               ],
               "use" : "official"
            }
         },
         "fullUrl" : "https://api.1up.health/dstu2/Practitioner/1003000167"
      },
      {
         "search" : {
            "mode" : "match"
         },
         "fullUrl" : "https://api.1up.health/dstu2/Practitioner/1003000175",
         "resource" : {
            "identifier" : [
               {
                  "value" : "1003000175",
                  "use" : "official",
                  "system" : "https://nppes.cms.hhs.gov"
               },
               {}
            ],
            "telecom" : [
               {
                  "value" : "6265810591",
                  "use" : "work",
                  "system" : "fax"
               },
               {
                  "system" : "phone",
                  "use" : "work",
                  "value" : "6263785315"
               },
               {
                  "value" : "6265810800",
                  "use" : "work",
                  "system" : "phone"
               },
               {}
            ],
            "active" : true,
            "gender" : "female",
            "id" : "1003000175",
            "practitionerRole" : [
               {
                  "specialty" : [
                     {
                        "coding" : [
                           {
                              "system" : "http://nucc.org/provider-taxonomy",
                              "code" : "122300000X",
                              "display" : "A dentist is a person qualified by a doctorate in dental surgery (D.D.S.) or dental medicine (D.M.D.), licensed by the s..."
                           }
                        ]
                     }
                  ],
                  "role" : {
                     "coding" : [
                        {
                           "system" : "http://nucc.org/provider-taxonomy",
                           "display" : "Dentist",
                           "code" : "122300000X"
                        }
                     ]
                  }
               }
            ],
            "address" : [
               {
                  "country" : "US",
                  "city" : "La Puente",
                  "state" : "Ca",
                  "use" : "work",
                  "line" : [
                     "322 N Azusa Ave Ste 202"
                  ]
               },
               {}
            ],
            "meta" : {
               "lastUpdated" : "2017-11-13T01:12:00.056Z",
               "versionId" : "9000000000000"
            },
            "resourceType" : "Practitioner",
            "name" : {
               "family" : [
                  "Reyes-Vasquez"
               ],
               "use" : "official",
               "given" : [
                  "Belinda"
               ],
               "suffix" : [
                  "D.D.S."
               ]
            }
         }
      },
      {
         "search" : {
            "mode" : "match"
         },
         "resource" : {
            "id" : "1003000183",
            "gender" : "male",
            "active" : true,
            "identifier" : [
               {
                  "value" : "CPT 97124",
                  "use" : "official",
                  "system" : "LABOR & INDUSTRIES Other WA"
               },
               {
                  "value" : "1003000183",
                  "use" : "official",
                  "system" : "https://nppes.cms.hhs.gov"
               },
               {}
            ],
            "telecom" : [
               {
                  "system" : "phone",
                  "use" : "work",
                  "value" : "2532284434"
               },
               {}
            ],
            "name" : {
               "use" : "official",
               "family" : [
                  "Cyphers"
               ],
               "suffix" : [
                  "L.M.P"
               ],
               "given" : [
                  "Dennis",
                  "James"
               ]
            },
            "resourceType" : "Practitioner",
            "meta" : {
               "versionId" : "9000000000000",
               "lastUpdated" : "2017-11-13T01:11:37.601Z"
            },
            "address" : [
               {
                  "country" : "US",
                  "use" : "work",
                  "state" : "Wa",
                  "line" : [
                     "6930 52Nd Ave W"
                  ],
                  "city" : "Tacoma"
               },
               {}
            ],
            "practitionerRole" : [
               {
                  "role" : {
                     "coding" : [
                        {
                           "system" : "http://nucc.org/provider-taxonomy",
                           "display" : "Massage Therapist",
                           "code" : "225700000X"
                        }
                     ]
                  },
                  "specialty" : [
                     {
                        "coding" : [
                           {
                              "display" : "An individual trained in the manipulation of tissues (as by rubbing, stroking, kneading, or tapping) with the hand or an...",
                              "code" : "225700000X",
                              "system" : "http://nucc.org/provider-taxonomy"
                           }
                        ]
                     }
                  ]
               }
            ]
         },
         "fullUrl" : "https://api.1up.health/dstu2/Practitioner/1003000183"
      }
   ],
   "type" : "searchset",
   "resourceType" : "Bundle",
   "total" : 16,
   "link" : [
      {
         "relation" : "self",
         "url" : "https://api.1up.health/dstu2/Practitioner"
      },
      {
         "relation" : "next",
         "url" : "https://api.1up.health/dstu2/Practitioner?_afterid=1003000183"
      }
   # DST}

Populated FHIR® Resources

Medications, Practitioners, and Organization resources are populated using open data. These all have public permissions and are returned when using any valid auth token.

Other Available Data

In addition to fully populated FHIR® resources, when data is imported into 1upHealth we appropriately link it to the appropriate codes. For example, LOINC, ICD, and DRGs.