City Health Dashboard

Data Access

Access the Dashboard Data

Data can be accessed using our API or the filtering and download feature at the bottom of the page.

Please see the data dictionary (PDF link below) for more details regarding downloadable data.

When should I cite City Health Dashboard?

City Health Dashboard should be cited when the data or graphics are used, including in published presentations, articles, research, blogs, policy documents, and other print or digital media. 

We encourage use of Dashboard data and visualizations, and suggest the following citation: 

Department of Population Health, NYU Langone Health. City Health Dashboard. https://www.cityhealthdashboard.com/. Accessed [INSERT DATE OF ACCESS].

Start here: Data Dictionary and Technical Documentation

Metadata files, provided below, guide the use of the downloadable data. The Dashboard strongly encourages users to review the data dictionary and technical document before beginning data analysis. Users should also review our FAQ for more on appropriate and inappropriate uses of Dashboard data.

Filtering and Downloading Data Files

Download Data Filtered By Metric, City and Year

Filter data by metrics and year

Type to find a metric and year

Accessing the API

The Dashboard displays more than one year of data for most metrics. Due to file size constraints, each downloadable CSV file contains a limited amount of data. For large data requests, you may need to break up your desired data into multiple downloads. For some cities, a metric estimate may not be available in the most recent year of data, but estimates are available in prior years of data. Users can confirm data availability for prior years for specific cities by consulting the website or the Data Dictionary.

API keys can be requested here.

API Tips

The following endpoints are available in our API files:

  • Geographic identifiers

  • Metrics

  • Metric data

  • Data sources

  • Demographic identifiers

Be sure to replace [api_key] with your actual API key without the brackets

  • https://www.cityhealthdashboard.com/api/data/metrics?token=[api_key]

Spaces in arguments are separated by a plus sign (+), not an underscore (e.g., New York is queried as New+York, not New York

  • https://www.cityhealthdashboard.com/api/data/metric-data/4?token=[api_key]&geo_name=New+York

Queries that yield over 1,000 results will be paginated to increase the efficiency of the query. You can use an optional “page” argument to move through result pages. For example:

  • https://www.cityhealthdashboard.com/api/data/metric-data/4?token=[api_key]&page=2

For more details, please refer to the Data Dictionary. You can also email [email protected] with any questions and comments about the Dashboard's API.

Questions or feedback?

Users are encouraged to contact us with comments or questions at [email protected]. We're glad to help you with data access and usage.