FHIR Bulk Data API

FHIR is normally used to enable access to data one patient or resource at a time, but new Bulk Data APIs (which use the $export operator) are making population level data transfer and analytics possible. There are two main use cases 1upHealth supports.

  1. Export any or all of your FHIR data
  2. Run population health analytics on top of this population

You can immediately have access to these features once you've signed up with the 1upHealth APIs. You don't need to setup any distributed file stores, analytic query engines, or indexes. You get that all out of the box on 1up.

Create a developer account

We Are Experts

Our team is literally setting the standards here. We are balloting the bulk data specification through the HL7 standards body along with support from the SMART Health IT team. Additionally, we are building THE reference implementation via the $1M LEAP Grant from the US government in our collaboration with Boston Children's Hospital.

Legislation & Policy

CMS is planning to transform its data pipeline to use FHIR and the bulk data specification. Soon millions of patients' medical claims data will be transmitted using the FHIR bulk data APIs. What that will ultimately lead to is most payor / provider relationships will lead to the use of these standard methods of data transfer. This standardization will drastically reduce the esoteric knowledge and interfaces currently required to transmit population level electronic health information.


For information about population-level data transfer and analytics, see our Analytics documentation.

FHIR $export Operator

Request the analytics bulk-data endpoint with the $export operator to retrieve a list of bulk data files for your client application to download.

    curl -XGET 'https://analytics.1up.health/bulk-data/${apiVersion}/$export' \
      -H "Authorization: Bearer accesstokenaccesstoken"

This will return at least one bulk data download file for each resource type for which resources exist. Optionally include a _type query parameter with a comma-separated list of FHIR resources to limit the types of resources that you want to export, e.g.


See the API reference for more details.

Use cases

Numerous use cases for bulk electronic health data transfer and analytics can be supported. Many examples solve or improve upon existing needs using a standards based approach and others will unlock the future of healthcare.

  • Population health analytics for managing risk or risk adjustments
  • Reporting on quality and costs
  • Multi EHR or data ware house integrations
  • Automating reporting for audits or other partners
  • Anonymized research data sets for public health
  • Public health surveillance
  • Network referrals and leakage analysis
  • Calculating HEDIS measures
  • Extracting features for machine learning models and, one day, decisions made by artificial intelligent doctor agents