American Community Survey 1-Year Data (2005-2022)

Skip Navigation

American Community Survey 1-Year Data (2005-2022)

September 14, 2023

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.

Detailed Tables, Subject Tables, Data Profiles, Comparison Profiles and Selected Population Profiles are available for the nation, all 50 states, the District of Columbia, Puerto Rico, every congressional district, every metropolitan area, and all counties and places (i.e., towns or cities) with populations of 65,000 or more.

Detailed Tables contain the most detailed estimates on all topics for all geographies. The data are presented as estimates.
Subject Tables provide a span of information on a particular ACS subject presented in the format of both estimates and percentages.
Data Profiles contain broad social, economic, housing, and demographic information. The data are presented as estimates and percentages.
Comparison Profiles are similar to Data Profiles but also include comparisons with past-year data. The current year data are compared with each of the last four years of data and include statistical significance testing.
Selected Population Profiles provide broad statistics for population subgroups by race, ethnicity, ancestry, tribal affiliation, and place of birth. The data are presented as estimates and percentages.

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.

2021

Variable Changes

Variables, and the values they represent, may change over time. Use this 2021 1YR API Changes document as a guide for which variables have changed from the prior year for 2021 ACS 1-Year Detailed Tables, Data Profiles and Subject Tables. See below for a description of each change type.

No Change - The variable has not changed from the prior year (most variables).
Updated - That variable has changed from the prior year and a matching variable for the current year has been found.
No Match - The variable has changed from the prior year and no matching or comparable variable has been found.

For table changes, check the ACS product changes webpage for source table changes.

2021 Table & Geography Changes

Learn more about changes to tables and geography for each American Community Survey data release.

Annotation Variables

In September 2016, ACS released annotation variables that return character representations of each estimate. Many annotations return as null. However, if an annotation variable returns a value, it provides important information about the estimate or margin of error. For example, if an estimate variable (variable ending in “E”) returns “-888888888”, the annotation variable will return “(X)”. Looking at the Notes on ACS Estimate and Annotation Values, this means the estimate is not applicable or not available. For a complete list of return values and their annotations, see:

Related Information

Notes on ACS Estimate and Annotation Values