Uninhabited dwellings by type of ownership
This API provides access to statistical series on uninhabited dwellings broken down by type of ownership, part of the Local Data Bank (Bank Danych Lokalnych, BDL) maintained by Statistics Poland (GUS). The data falls under the housing economy and municipal infrastructure category, specifically dwelling stock, and is organized as subject P3966. It offers yearly territorial series covering all administrative levels of Poland, from voivodship down to gmina, with units identified using official TERYT territorial codes. The dataset supports analysis of housing vacancy patterns across Polish regions and municipalities.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › DWELLING STOCK. Local Data Bank (BDL) subject P3966: 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 identifying the specific ownership type and measure of uninhabited dwellings.GUS variable id selecting the measured series of subject P3966 (the n1/n2 dimension combination): 1646208=owned by housing cooperatives / total uninhabited dwelling [-]; 1646209=owned by housing cooperatives / total uninhabited dwelling [m2]; 1646210=owned by housing cooperatives / due to waiting for settlement [-]; 1646211=owned by housing cooperatives / due to waiting for settlement [m2]; 1646212=owned by housing cooperatives / due to the purpose of renovation [-]; 1646213=owned by housing cooperatives / due to the purpose of renovation [m2]; 1646214=owned by housing cooperatives / due to the intended for demolition [-]; 1646215=owned by housing cooperatives / due to the intended for demolition [m2]; 1646216=owned by housing cooperatives / due to poor technical condition [-]; 1646217=owned by housing cooperatives / due to poor technical condition [m2]; 1646218=owned by housing cooperatives / due to other reasons [-]; 1646219=owned by housing cooperatives / due to other reasons [m2]; 1646220=companies stocks / total uninhabited dwelling [-]; 1646221=companies stocks / total uninhabited dwelling [m2]; 1646222=companies stocks / due to waiting for settlement [-]; … (72 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P3966 for the full list). |
| unit_levelUnit level | integer | Territorial aggregation level, from country down to gmina.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 recorded 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 for the territorial unit.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 | Numeric value of the measured variable for the unit and year.Numeric value of the measured variable for the unit and year. |
| attr_idAttr id | integer | GUS data quality or annotation flag for the value.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 |
|---|---|---|---|---|---|---|---|
| 1646208 | — | 2018 | 000000000000 | POLAND | — | 4288 | 1 |
| 1646208 | — | 2020 | 000000000000 | POLAND | — | 4318 | 1 |
| 1646208 | — | 2022 | 000000000000 | POLAND | — | 4563 | 1 |
| 1646208 | — | 2024 | 000000000000 | POLAND | — | 4107 | 1 |
| 1646208 | — | 2018 | 010000000000 | MACROREGION POŁUDNIOWY | — | 1123 | 1 |
| 1646208 | — | 2020 | 010000000000 | MACROREGION POŁUDNIOWY | — | 1199 | 1 |
| 1646208 | — | 2022 | 010000000000 | MACROREGION POŁUDNIOWY | — | 1198 | 1 |
| 1646208 | — | 2024 | 010000000000 | MACROREGION POŁUDNIOWY | — | 1084 | 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/P3966
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/1646208?page-size=10&format=json&lang=en'Yearly values of variable 1646208 (owned by housing cooperatives / total uninhabited dwelling [-]) 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.