Fully queryable REST API
The Open Data API permits access to the open datasets available through Health IT Data. The table below lists all the datasets accessible through the API (not all datasets are accessible through this API at this time.) Below the table, you can find full documentation of the API and how to build queries to filter and sort a dataset. This documentation can also be found on Health IT Data /help page.
This is an ongoing project managed by the Office of the National Coordinator for Health Information Technology, an agency of the Department of Health and Human Services. If you have any questions or concerns about this information, please contact ONC.Request@hhs.gov.
The table below lists all the open datasets (/data) accessible through Health IT Data Open Data API. The table lists the dataset, whether or not its API accessible, and the base API call. The API call returns a JSON response. See the documentation below the table for more information on using the API.
|Dataset (select to view data documentation)||API Accessible (Y/N)||API Call|
|2015 Edition Market Readiness for Hospitals and Clinicians Data||Y||
|Centers for Medicare & Medicaid Services (CMS) EHR Incentive Program Measures||Y||
|EHR Developers Reported by Health Care Providers Participating in Federal Programs||Y||
|EHR Products Used for Meaningful Use Attestation||N|
|Effects of Meaningful Use Functionalities on Health Care Quality, Safety, and Efficiency||Y||
|Electronic Prescribing Adoption and Use by County||Y||
|Electronic Prescribing Adoption and Use by State||Y||
|Federal Health IT Strategic Plan: 2015-2020 Goals||Y||
|Hospital Public Health Reporting||Y||
|Non-federal Acute Care Hospital Health IT Adoption and Use||Y||
|ONC Budget Performance Measure Data||Y||
|ONC Community College Consortia to Educate Health IT Professionals Program Key Performance Indicators (KPIs)||Y||
|ONC Health Information Technology for Economic and Clinical Health (HITECH) Grantee Crosswalk||Y||
|ONC Health Information Technology for Economic and Clinical Health (HITECH) Grantee List||Y||
|ONC Regional Extension Centers (REC) Key Performance Indicators (KPIs) by County||Y||
|ONC Regional Extension Centers (REC) Key Performance Indicators (KPIs) by Grantee||Y||
|ONC Regional Extension Centers (REC) Key Performance Indicators (KPIs) by State||Y||
|Office-based Health Care Providers Database||Y||
|Office-based Physician Health IT Adoption and Use||Y||
|State Health IT Policy Levers Activities Catalog||Y||
|State Health IT Privacy and Consent Laws and Policies||Y||
|Strategic Health IT Advanced Research Projects (SHARP) Output Inventory||Y||
|Students Trained through ONC Workforce Programs||Y||
Open API Documentation
This documentation provides instructions on how to query Health IT Data's open API to filter, sort and format an open dataset. You can use this documentation to use the open API in your application or website. Not all of the open datasets available through Health IT Data are accessible through the API. See the API table to determine accessibility to the open API.
Begin your query by entering the API source:
Next, get the source filename of the CSV formatted dataset, and join that to the API source with a '?':
This query, on its own, will return a JSON formatted version of the dataset. You can also filter and sort the dataset, and choose what format (CSV or XML) you want the response to be.
To filter a dataset, choose the data field you want to filter (e.g., you likely want to filter by a categorical data field with a finite set of options, like states, time periods, provider types or ZIP codes.) For example, you can filter the referenced dataset by U.S. state and/or time period. You join these filter options to the end of the existing query string:
Filter by region (U.S. state):
Filter by region and period (year):
Together, the query string would be written thusly:
The above string will provide a JSON response by default. To return the response in XML or CSV format, you must append a
&format parameter to the query with the desired data format: &format=csv for a CSV response or &format=xml for a XML response.
If you want the above query in CSV format instead of the default JSON format, simply append the appropriate parameter at the end of the string, thusly:
Always reference a dataset's documentation to build an API query. The documentation page includes all the information you need, including a dataset's filename and data fields.