American Community Survey 1-Year Supplemental Data (2014 - 2022)

Skip Navigation

American Community Survey 1-Year Supplemental Data (2014 - 2022)

October 19, 2023

American Community Survey Supplemental Data

The American Community Survey (ACS) is an ongoing survey that provides data every year—giving communities the current information they need to make important decisions. The ACS covers a broad range of topics about social, economic, housing, and demographic characteristics of the U.S. population.

Supplemental Estimates are a subset of simplified Detailed Tables providing access to the most recent ACS data at a lower population threshold than the standard 1-year tables. Supplemental Estimates are available for geographic areas with populations of 20,000 or more.

To create an API call, you must enter a specific URL into the address bar of a web browser. The call will vary depending on the following factors:

Year of data release
Dataset (ACS 1-year or 5-year)
Table ID
Geography level

Please review the example API calls for each of the table types listed below and use those examples to build your API calls. API calls are also available for tables found in data.census.gov by selecting the API function in the tool bar. Visit the API Resources page for tutorial videos, workshops and other tools.

The API is one of several ways to access ACS data. Visit the ACS Data page to find all the ways to access ACS data.

2016

2016 1-Year Supplemental Estimates

Supplemental Estimates:

API Call: api.census.gov/data/2016/acs/acsse?get=NAME,K200001_001E&for=state:*&key=YOUR_KEY_GOES_HERE
2016 1-Year Supplemental Estimates Variables [ html | xml | json ]
ACS Technical Documentation
Examples and Supported Geography

Notes on Supplemental Estimates

Please note that the Supplemental Estimates may return the following in place of data:

An '**' entry in the margin of error column indicates that either no sample observations or too few sample observations were available to compute a standard error and thus the margin of error. A statistical test is not appropriate.

An '-' entry in the estimate column indicates that either no sample observations or too few sample observations were available to compute an estimate, or a ratio of medians cannot be calculated because one or both of the median estimates falls in the lowest interval or upper interval of an open-ended distribution.

An '***' entry in the margin of error column indicates that the median falls in the lowest interval or upper interval of an open-ended distribution. A statistical test is not appropriate.

An '*****' entry in the margin of error column indicates that the estimate is controlled. A statistical test for sampling variability is not appropriate.

Notes on Annotation Values

Supplemental Estimates contain variables ending in E, EA, M and MA.

Variable Type	Title	Meaning
E	Estimate	A numeric representation of the estimate.
EA	Estimate Annotation	A character representation of the estimate. If an Estimate Annotation exists, use this value in place of the Estimate.
M	Margin of Error	A numeric representation of the margin of error.
MA	Margin of Error Annotation	A character representation of the margin of error. If a Margin of Error Annotation exists, use this value in place of the Margin of Error.

Examples with Annotations

Example #1:

In the following example, the character value “*****” is returned by K200104_001MA. Using the notes above, this indicates the estimate is controlled.

api.census.gov/data/2016/acs/acsse?get=NAME,K200104_001M,K200104_001MA&for=us:*&key=YOUR_KEY_GOES_HERE

Returns:

[["NAME","K200104_001M","K200104_001MA","us"],

["United States","-555555555","*****","1"]]

Example #2:

In the following example, the character value “-“ is returned for K201905_001EA. Using the notes above, this indicates the estimate could not be calculated.

api.census.gov/data/2016/acs/acsse?get=NAME,K201905_001E,K201905_001EA&for=place:67825&in=state:49=YOUR_KEY_GOES_HERE

Returns:

[["NAME","K201905_001E","K201905_001EA","state","place"],

["Saratoga Springs city, Utah","-666666666","-","49","67825"]]