Variables, and the values they represent, may change over time. Use this 2023 1YR API Changes document as a guide for which variables have changed from the prior year for 2023 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.

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:

• Example Call: api.census.gov/data/2023/acs/acs1?get=NAME,group(B01001)&for=us:1&key=YOUR_KEY_GOES_HERE
• 2023 ACS Detailed Tables Variables [ html | xml | json ]
• ACS Technical Documentation
• Examples and Supported Geography

• Example Call: api.census.gov/data/2023/acs/acs1/subject?get=NAME,group(S0101)&for=us:1&key=YOUR_KEY_GOES_HERE
• 2023 ACS Subject Tables Variables [ html | xml | json ]
• ACS Technical Documentation
• Examples and Supported Geography

• Example Call: api.census.gov/data/2023/acs/acs1/profile?get=group(DP02)&for=us:1&key=YOUR_KEY_GOES_HERE
• 2023 ACS Data Profiles Variables [ html | xml | json ]
• ACS Technical Documentation
• Examples and Supported Geography

• Example Call: api.census.gov/data/2023/acs/acs1/cprofile?get=group(CP05)&for=us:1&key=YOUR_KEY_GOES_HERE
• 2023 ACS Comparison Profile Variables [ html | xml | json ]
• ACS Technical Documentation
• Examples and Supported Geography

• Example Call: api.census.gov/data/2023/acs/acs1/spp?get=NAME,group(S0201)&for=us:1&POPGROUP=001&key=YOUR_KEY_GOES_HERE
• 2023 ACS Selected Population Profiles Variables [ html | xml | json ]
• ACS Technical Documentation
• Examples and Supported Geography