American Community Survey 1-Year Data 2019

Variable Changes

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:

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:

All queries to the Census Data API now require an API key. Please cut and paste the Example Calls below into your web browser and replace YOUR_KEY_GOES_HERE with your personal API Key. 

If you do not have an API Key, request one here.

Detailed Tables

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

Subject Tables

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

Data Profiles

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

Comparison Profile

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

Selected Population Profiles

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

Page Last Revised - May 12, 2026