Introduction

The America’s Health Rankings API provides access to the America’s Health Rankings data. The API is a GraphQL API that provides access to the data in a structured way.

If you are not familiar with GraphQL, you can learn more about it in our FAQ page.

Datasets

Our offering of Health Measures and its data comprises multiple datasets with unique contents. Each dataset contains unique data and may have different query parameters.

The data_A dataset allows users to access the data from measures actively maintained through the three most recent America’s Health Rankings reports: the Annual Report (opens in a new tab), the Senior Report (opens in a new tab) and the Health of Women and Children Report (opens in a new tab). This dataset is updated thrice annually with the publication of each report and reflects the most recently available data from each source according to each report’s data close date. Where available, health measures are stratified by population groups, including age, disability status, education, gender and sexual orientation, income, metropolitan status, race/ethnicity and veteran status. This dataset also contains data from the 2016, 2018 and 2020 publications of the Health of Those Who Have Served Report (opens in a new tab) and the 2017 Health of Women Who Have Served Report (opens in a new tab).

The data_B dataset allows users to access data from the AHR disparities series. These special issues offer a deep dive point-in-time analysis of disparities within key topics and populations. The dataset currently includes data from the 2024 Maternal and Infant Health Disparities Data Brief (opens in a new tab), the 2023 Mental and Behavioral Health Data Brief (opens in a new tab), the 2021 Health Disparities Report (opens in a new tab) and the 2023 release of Chronic Condition Care Data (opens in a new tab).

You can find more information about the available datasets in the API Reference.