Housing Database

All DCP Housing Database Files
The NYC Department of City Planning’s (DCP) Housing Database contains all NYC Department of Buildings (DOB)-approved housing construction and demolition jobs filed or completed in NYC since January 1, 2010.It includes the three primary construction job types that add or remove residential units: new buildings, major alterations, and demolitions, and can be used to determine the change in legal housing units across time and space. Records in the Database are geocoded to the greatest level of precision possible, subject to numerous quality assurance and control checks, recoded for usability, and joined to other housing data sources relevant to city planners and analysts.

Please see DCP’s annual Housing Production Snapshot summarizing findings from the 22Q4 data release here. Additional Housing and Economic analyses are also available.

DOB Open Data are the primary source for the NYC Department of City Planning’s (DCP) Housing Database, and despite efforts DCP makes to correct errors, there are still unknown inaccuracies throughout the data. The data are administrative in nature, and most of the information associated with a record is provided by the applicant, and not necessarily verified by DCP.

The DCP Housing Database is based on DOB Open Data to identify housing construction. However, not all construction in NYC occurs legally by approval through the DOB. Illegal conversions of the housing stock may be prevalent in certain neighborhoods but are not represented in this data.

DCP uses information such as job description, occupancy codes, and unit change to differentiate hotels and class B units from class A housing units. However, there may be hotels and class B units that DCP could not identify using these means.

Release 23Q4	Download
ESRI Shapefiles
ESRI File Geodatabase
CSV

PROJECT LEVEL FILES

The NYC Department of City Planning’s (DCP) Housing Database Project-Level Files contain all NYC Department of Buildings (DOB)-approved housing construction and demolition jobs filed or completed in NYC since January 1, 2010. It includes the three primary construction job types that add or remove residential units: new buildings, major alterations, and demolitions, and can be used to determine the change in legal housing units across time and space. Records in the Database are geocoded to the greatest level of precision possible, subject to numerous quality assurance and control checks, recoded for usability, and joined to other housing data sources relevant to city planners and analysts.

Project Level Files Data Dictionary

Individual Features
File Name	Name	Description	REST	GeoJSON	CSV	Shapefile
HousingDB _post2010	HousingDB Post-2010	Data for all active and completed new buildings, demolitions, and major alterations involving housing units in NYC since 2010
HousingDB _post2010 (inactives included)	HousingDB Post-2010 (Inactives Included)	Data for all new buildings, demolitions, and major alterations involving housing units in NYC since 2010, including inactive projects

UNIT CHANGE SUMMARY FILES

The NYC Department of City Planning’s (DCP) Housing Database Unit Change Summary Files provide the net change in Class A housing units since the 2010 and the count of units pending completion for commonly used political and statistical boundaries. These tables are aggregated from the DCP Housing Database Project-Level Files, which is derived from Department of Buildings (DOB)-approved housing construction and demolition jobs filed or completed in NYC since January 1, 2010. Net housing unit change is calculated as the sum of the three primary construction job types that add or remove residential units: new buildings, major alterations, and demolitions. These files can be used to determine the change in legal housing units across time and space.

Unit Change Summary File Data Dictionary

Individual Features
File Name	Name	REST	GeoJSON	CSV	Shapefile
HousingDB _by_2020_CensusBlock	Census Block Unit Change Summary File
HousingDB _by_2020_CensusTract	Census Tract Unit Change Summary File
HousingDB_by_2020_NTA	Neighborhood Tabulation Area (NTA) Unit Change Summary File
HousingDB_by_2020_CDTA	Community District Tabulation Area (CDTA) Unit Change Summary File
HousingDB_by _CommunityDistrict	Community District Unit Change Summary File
HousingDB_by _ 2024_CityCouncilDistrict	City Council District Unit Change Summary File

Disclaimer
The BYTES of the BIG APPLE software, data and geographic base map files being provided by the Department of City Planning (DCP) on DCP’s website for informational purposes only. DCP does not warranty the completeness, accuracy, content, or fitness for any particular purpose or use of BYTES of the BIG APPLE products, nor are any such warranties to be implied or inferred with respect to BYTES of the BIG APPLE products as furnished on the website. DCP and the City are not liable for any deficiencies in the completeness, accuracy, content, or fitness for any particular purpose or use of BYTES of the BIG APPLE products, or applications utilizing BYTES of the BIG APPLE products, provided by any third party.