API Reference

This query will return a collection of data points. Data can be limited to a specific state. For querying data associated with one or more specific health measures, use the “measures” query.

The number of items you would like to skip, useful for pagination of large data sets.

A U.S. state postal code. Eg. “NY”. For national data use, “ALL”.

The number of items you would like to retrieve, useful for pagination of large data sets.

This query will return an individual data point. Data can be limited to a specific state. For querying data associated with one or more specific health measures, use the “measures” query.

The id of an individual data record.

This query will return an individual measure. You must provide a “measureId” argument to specify which measure you are seeking.

The id of an individual measure.

This query will return a collection of measures. Use the “skip” and “take” parameters to paginate the data.

The number of items you would like to skip, useful for pagination of large data sets.

The number of items you would like to retrieve, useful for pagination of large data sets.

This query will return a collection of population categories. Use the “skip” and “take” parameters to paginate the data.

The number of items you would like to skip, useful for pagination of large data sets.

The number of items you would like to retrieve, useful for pagination of large data sets.

This query will return an individual population category, such as “Age”. You must provide a “populationCategoryId” argument to specify which population category you are seeking.

The id of an individual population category.

This query will return an individual population. You must provide a “populationId” argument to specify which population you are seeking.

The id of an individual population.

This query will return a collection of populations. Use the “skip” and “take” parameters to paginate the data.

The number of items you would like to skip, useful for pagination of large data sets.

The number of items you would like to retrieve, useful for pagination of large data sets.

This query will return an individual report. You must provide a “reportId” argument to specify which report you are seeking.

The id of an individual report.

This query will return a collection of reports. Use the “skip” and “take” parameters to paginate the data.

The number of items you would like to skip, useful for pagination of large data sets.

The number of items you would like to retrieve, useful for pagination of large data sets.

This query will return an individual data source. You must provide a “sourceId” argument to specify which population category you are seeking.

The id of an individual source.

This query will return a collection of data sources. Use the “skip” and “take” parameters to paginate the data.

The number of items you would like to skip, useful for pagination of large data sets.

The number of items you would like to retrieve, useful for pagination of large data sets.

Information relevant to the MeasureDatum for instances in which data is not available, suppressed, or has other nuances to be taken into account.

The date or time period from which the data is from.

The end date of the time period of the data. For data from a given year, endDate is set to “1/1/YYYY”. This field is useful for handling date ranges (i.e., startDate - endDate).

The lower 95% confidence interval, where available. Not all measures or data years for a specific measure have confidence intervals available.

The name of the measure.

The ID unique to each data.

The rank of each state’s value by healthiest (1) to least healthy (50).

The start date of the time period of the data. For data from a given year, startDate is set to “1/1/YYYY”. This field is useful for handling date ranges (i.e., startDate - endDate).

The two-letter postal code of a state. Note the United States value is labeled as “ALL”.

The upper 95% confidence interval, where available.

The value for a given measure, state, and data year.

The data points for the measure.

The description of the measure.

The value type of the measure data value field, such as “Percent”, “Currency”, or “Numeric”.

Indicates a positive association with health. For example, the measure ‘Exercise’ would return the value “Y” while Smoking would return the value “N”.

The ID unique to the measure. Measures with the same ID are comparable over time.

The name of the measure.

The population that the measure is for, such as “Hispanic” or “Ages 18-24”.

The precision of the measure data value field, indicating how many decimal places data should be displayed.

The original source of the measure's data.

Measures pertaining to slices of the population - subpopulations. Only "root" measures have subpopulations. Note that some subpopulations are treated as root measures in this data set if they are featured in Health of Women and Children or Senior reports.

The description of the measure’s units, typically a shortened version of description. For example, “Deaths per 100,000 population.”

The name of the population category.

The ID of the population category.

The populations associated with each category.

The name of the measure.

The name of the population.

The category of the population group, such as “Race” or “Age”.

The ID of the population.

The Report publish date

The name of the report

The ID of the Report

The type of report

The name of the measure.

The name of the original data source.

The ID of the source.