The Survey of Market Absorption of New Multifamily Units (SOMA), sponsored by the Department of Housing and Urban Development (HUD), uses the Census Bureau's Survey of Construction (SOC) as its sampling base. Each month, a sample of residential buildings containing five or more units is selected for SOMA. The initial 3-month interview collects information on amenities, rent or sales price levels, number of units, type of building, and the number of units taken off the market (absorbed). Field representatives conduct subsequent interviews, if necessary, at 6, 9, and 12 months after completion.

• API Call: api.census.gov/data/timeseries/soma?key=YOUR_KEY_GOES_HERE
• Examples and Supported Geographies: api.census.gov/data/timeseries/soma.html?key=YOUR_KEY_GOES_HERE
• Variables: api.census.gov/data/timeseries/soma/variables.html?key=YOUR_KEY_GOES_HERE
• Example Calls:  

Show estimates for 2022 annual completions:

api.census.gov/data/timeseries/soma?get=NAME,COMP_YEAR,COMP_QTR,TABLE_TOPIC_TITLE,ESTIMATE_TYPE_TITLE,UNIT_TYPE_TITLE,COL_CHAR_TITLE,DESCR_UNIQ_COL_CHAR_CODE,TABLE_STUB_TITLE,DESCR_UNIQ_ROW_CHAR_CODE,DESCR_UNIQ_COL_ABS_CODE,ESTIMATE,ESTIMATE_OVERRIDE&for=us:*&time=2022&ESTIMATE_TYPE_CODE=A&key=YOUR_KEY_GOES_HERE

Show estimates for 2023 quarter four absorptions:

api.census.gov/data/timeseries/soma?get=NAME,COMP_YEAR,COMP_QTR,TABLE_TOPIC_TITLE,ESTIMATE_TYPE_TITLE,UNIT_TYPE_TITLE,COL_CHAR_TITLE,DESCR_UNIQ_COL_CHAR_CODE,TABLE_STUB_TITLE,DESCR_UNIQ_ROW_CHAR_CODE,DESCR_UNIQ_COL_ABS_CODE,ESTIMATE,ESTIMATE_OVERRIDE&for=us:*&time=2023-Q3&ESTIMATE_TYPE_CODE=Q&key=YOUR_KEY_GOES_HERE

Show estimates and margins of error for 2023 quarter four absorptions by furnished/unfurnished apartments:

api.census.gov/data/timeseries/soma?get=NAME,COMP_YEAR,COMP_QTR,TABLE_TOPIC_TITLE,ESTIMATE_TYPE_TITLE,UNIT_TYPE_TITLE,COL_CHAR_TITLE,DESCR_UNIQ_COL_CHAR_CODE,TABLE_STUB_TITLE,DESCR_UNIQ_ROW_CHAR_CODE,DESCR_UNIQ_COL_ABS_CODE,ESTIMATE,ESTIMATE_OVERRIDE,MOE,MOE_OVERRIDE&for=us:*&time=2023-Q3&ESTIMATE_TYPE_CODE=Q&COL_CHAR_CODE=9&UNIT_TYPE_CODE=R&key=YOUR_KEY_GOES_HERE

Show estimates for 2023 quarter four median sales prices for condominium and cooperative units:

api.census.gov/data/timeseries/soma?get=NAME,COMP_YEAR,COMP_QTR,TABLE_TOPIC_TITLE,ESTIMATE_TYPE_TITLE,UNIT_TYPE_TITLE,COL_CHAR_TITLE,DESCR_UNIQ_COL_CHAR_CODE,TABLE_STUB_TITLE,DESCR_UNIQ_ROW_CHAR_CODE,DESCR_UNIQ_COL_ABS_CODE,ESTIMATE,ESTIMATE_OVERRIDE&for=us:*&time=2023-Q3&TABLE_TOPIC_CODE=2&UNIT_TYPE_CODE=C&DESCR_UNIQ_ROW_CHAR_CODE=Median%20(dollars)&DESCR_UNIQ_COL_ABS_CODE=Total%20units%20completed&key=YOUR_KEY_GOES_HERE