U.S. flag

                    An official website of the United States government

                        Here’s how you know
                    Here’s how you know**Official websites use .gov**
                                
                                A **.gov** website belongs to an official government organization in the United States.
                    **Secure .gov websites use HTTPS**
                                
                                A **lock** (A locked padlock) or **https://** means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.
 
 Skip Header

    About
    
        Available APIs
    
        Guidance
    
        Latest Releases

				
				
                

                Search data, events, resources, and more

                Search

          
        
            
            
	
	
	Search

	

	Search

            Menu

	The Census Bureau's API allows developers to design web and mobile apps to explore or learn more about America's changing population and economy.

                    

                    About Developers
                        
                            App Gallery
                        
                            Terms of Service
                        Request an API Key
                        
                            Developers' Forum
                        
                            Geography
                        
                            Contact Us
            
                
            
                Guidance for Developers
                        
                            Census Data API User Guide
                        
                            Census Microdata API User Guide
                        Census Data API Discovery Tool
                        
                            Workshop: Basics of Using the Census API
                        
                            View All Video Tutorials
            
                Latest Data Releases
                        
                            News
                        Updates
                        
                            Contact Us


      
    
    About
                
                    Available APIs
                
                    Guidance
                
                    Latest Releases
                

                About
                    
                        Available APIs
                    
                        Guidance
                    
                        Latest Releases

                  
                
                    About Developers
                        
                            App Gallery
                        
                            Terms of Service
                        
                            Request an API Key
                        
                            Developers' Forum
                        
                            Geography
                        
                            Contact Us
                
                    
                
                    Guidance for Developers
                        
                            Census Data API User Guide
                        
                            Census Microdata API User Guide
                        
                            Census Data API Discovery Tool
                        
                            Workshop: Basics of Using the Census API
                        
                            View All Video Tutorials
                
                    Latest Data Releases
                        
                            News
                        
                            Updates
                        
                            Contact Us
 
 //
            Census.gov
                    /
		
            
            Developers
                    /
		
            
            Available APIs
                    /
		
            
            Survey of Market Absorption of New Multifamily Units (SOMA)
 Survey of Market Absorption of New Multifamily Units (SOMA)
 Skip Navigation Within Developers
 About
	
		App Gallery
	
		Available APIs
	
		Developers' Forum
	
		Geography
	
		Guidance for Developers
	
		News
	
		Terms of Service
	
		UpdatesWithin Developers

			Within Developers
				
					About
				
					App Gallery
				
					Available APIs
				
					Developers' Forum
				
					Geography
				
					Guidance for Developers
				
					News
				
					Terms of Service
				
					Updates
 Survey of Market Absorption of New Multifamily Units (SOMA)
 February 27, 2024
 Share  Facebook X (Twitter) LinkedIn
 
 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.
 Survey of Market Absorption
 API Call:api.census.gov/data/timeseries/soma
Examples and Supported Geographies: api.census.gov/data/timeseries/soma.html
Variables: api.census.gov/data/timeseries/soma/variables.html
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
 Survey of Market Absorption of New Multifamily Units (SOMA)
            
            

            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).
 Related Information
 Developers' Forum
            
            

            Need help? Check out our Developer Forum to submit questions, share your apps, and provide feedback. FTP Server
            
            

            To download full datasets, visit our FTP Server.
 
 
 Thumbs Up ImageYes
            Thumbs Down ImageNo
 Top
 Back to Header Receive Updates
	        To sign up for updates please enter your email address.
        
        Enter your email address
	        Subscribe

	


            

            Stay Current
                            
                            America Counts
                                
                                    Director’s Blog
                                
                                    Deputy Director’s Blog
                                
                                    Random Samplings
                                
                                    Research Matters

                        Stay Connected
                            
                            Contact
                                
                                    Support
                                
                                    Jobs

                    Follow

	            Information Quality

                    |
	            
                    Data Linkage Infrastructure

                    |
	            
                    Data Protection and Privacy Policy

                    |
	            
                    Accessibility

                    |
	            
                    FOIA

                    |
	            
                    Inspector General

                    |
	            
                    No FEAR Act

                    |
	            
                    U.S. Department of Commerce

                    |
	            
                    USA.gov

            Measuring America's People, Places, and Economy