Dwelling stocks
HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › DWELLING STOCK. Local Data Bank (BDL) subject P2166: 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 of subject P2166 (the n1/n2 dimension combination): 60811=total / dwellings [-]; 60808=total / rooms [-]; 60813=total / useful floor area of dwellings [m2]; 60807=in urban areas / dwellings [-]; 60809=in urban areas / rooms [-]; 60810=in urban areas / useful floor area of dwellings [m2]; 60812=in rural areas / dwellings [-]; 60814=in rural areas / rooms [-]; 60806=in rural areas / useful floor area of dwellings [m2]. |
| unit_levelUnit level | integer | 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 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 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 | — |
| teryt_tercTeryt terc | string | 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 | — |
| attr_idAttr id | integer | GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 2 hours 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)
| year | unit_id | unit_name | teryt_terc | value | attr_id |
|---|---|---|---|---|---|
| 1995 | 011212001011 | Bochnia | 1201011 | 8563 | 1 |
| 1996 | 011212001011 | Bochnia | 1201011 | 8592 | 1 |
| 1997 | 011212001011 | Bochnia | 1201011 | 8654 | 1 |
| 1998 | 011212001011 | Bochnia | 1201011 | 8685 | 1 |
| 1999 | 011212001011 | Bochnia | 1201011 | 8737 | 1 |
| 2000 | 011212001011 | Bochnia | 1201011 | 8797 | 1 |
| 2001 | 011212001011 | Bochnia | 1201011 | 8875 | 1 |
| 2002 | 011212001011 | Bochnia | 1201011 | 9087 | 11 |
Live sample captured at profiling time — values may have changed upstream.
Using the API
Configuration
- Base URL
- https://bdl.stat.gov.pl/api/v1/subjects/P2166
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/60811?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 60811 (total / 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.