Variables, and the values they represent, may change over time. If you have used variables in prior year releases, check the ACS product changes webpage for source table changes. If the variable you have been using comes from a table that has changed from the prior year, check the variables list (variables.html) and compare the variable concept and label to be sure you are requesting the correct estimate. For information on these changes, visit:

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/2018/acs/acs1?get=NAME,group(B01001)&for=us:1&key=YOUR_KEY_GOES_HERE
• 2018 ACS Detailed Tables Variables [ html | xml | json ]
• ACS Technical Documentation
• Examples and Supported Geography

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

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

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

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