Unoccupied apartments in the municipal resource (vacant)
This API provides access to subject P2908 of Poland's Local Data Bank (BDL), covering unoccupied (vacant) apartments within the municipal dwelling stock, under the Housing Economy and Municipal Infrastructure category. It offers yearly territorial time series from the voivodship down to the gmina level, with statistical units identified by TERYT territorial codes. The dataset is maintained by GUS, Poland's Central Statistical Office, and is freely accessible without authentication, supporting analysis of housing vacancy trends across administrative regions of Poland.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › DWELLING STOCK. Local Data Bank (BDL) subject P2908: yearly territorial series for Poland (voivodship to gmina level), units keyed by TERYT ids.
Trust score
How is this computed?Weighted across five axes. Tap a ring for what it measures.
Data schema (8 fields)
Click a field to see example values.
| Field | Type | Description |
|---|---|---|
| variable_idVariable id | string | GUS variable id selecting the measured series (vacancy reason and metric type).GUS variable id selecting the measured series of subject P2908 (the n1/n2 dimension combination): 1646172=total uninhabited dwelling / dwellings [-]; 1646173=total uninhabited dwelling / useful floor area of dwellings [m2]; 1646174=due to waiting for settlement / dwellings [-]; 1646175=due to waiting for settlement / useful floor area of dwellings [m2]; 1646176=due to the purpose of renovation / dwellings [-]; 1646177=due to the purpose of renovation / useful floor area of dwellings [m2]; 1646178=due to the intended for demolition / dwellings [-]; 1646179=due to the intended for demolition / useful floor area of dwellings [m2]; 1646180=due to poor technical condition / dwellings [-]; 1646181=due to poor technical condition / useful floor area of dwellings [m2]; 1646182=due to other reasons / dwellings [-]; 1646183=due to other reasons / useful floor area of dwellings [m2]. |
| unit_levelUnit level | integer | Territorial aggregation level, from Poland (0) down to gmina (6).Territorial aggregation level: 0=Poland, 1=macroregion, 2=voivodship (województwo), 3=region, 4=subregion, 5=powiat, 6=gmina. |
| year | integer | Reference year of the yearly data value.Reference year of the value (yearly series, back to 1995 for the oldest subjects). Filters server-side via the API's year parameter. |
| unit_idUnit id | string | 12-digit BDL code identifying the territorial unit.12-digit BDL territorial-unit id (macroregion+voivodship+region+subregion+powiat+gmina+type digits). An equality filter pins the unit server-side (unit-parent-id). |
| unit_nameUnit name | string | Name of the territorial unit.Name of the territorial unit. |
| teryt_tercTeryt terc | string | TERYT TERC administrative code derived from the unit id.TERYT TERC territorial code derived from the unit id (2 digits = voivodship, 4 = powiat, 7 = gmina incl. type digit; empty for NUTS-only units). |
| value | number | Measured value for the selected variable, unit and year.Measured value for the selected variable, unit and year. |
| attr_idAttr id | integer | GUS attribute id flagging data quality or annotation status.GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 5 days ago.
Query the data
Pick columns and a sort, then fetch a live preview straight from the source. Choose an API-filterable column (marked ▾) under “Where” to pick from its list of values.
Sample data (8 records)
| variable_id | unit_level | year | unit_id | unit_name | teryt_terc | value | attr_id |
|---|---|---|---|---|---|---|---|
| 1646172 | 6 | 2003 | 011212001011 | Bochnia | 1201011 | 3 | 1 |
| 1646172 | 6 | 2005 | 011212001011 | Bochnia | 1201011 | 4 | 1 |
| 1646172 | 6 | 2007 | 011212001011 | Bochnia | 1201011 | 11 | 1 |
| 1646172 | 6 | 2009 | 011212001011 | Bochnia | 1201011 | 9 | 1 |
| 1646172 | 6 | 2013 | 011212001011 | Bochnia | 1201011 | 17 | 1 |
| 1646172 | 6 | 2015 | 011212001011 | Bochnia | 1201011 | 12 | 1 |
| 1646172 | 6 | 2016 | 011212001011 | Bochnia | 1201011 | 16 | 1 |
| 1646172 | 6 | 2018 | 011212001011 | Bochnia | 1201011 | 34 | 1 |
Live sample captured at profiling time — values may have changed upstream.
Verification Status
Using the API
Configuration
- Base URL
- https://bdl.stat.gov.pl/api/v1/subjects/P2908
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/1646172?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 1646172 (total uninhabited dwelling / dwellings [-]) per territorial unit. Filters: unit-level=0–6, year=YYYY, unit-parent-id={12-digit unit id}; page-size ≤ 100. Anonymous limits: 5 req/s, 100 req/15 min.
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.