Dwelling stocks - Users of dwellings with overdue rent
This API provides access to subject P1972 of Poland's Local Data Bank (BDL), covering dwelling stocks and users of dwellings with overdue rent under the housing economy and municipal infrastructure category, archival data section. It offers yearly territorial time series from the voivodship down to the gmina level, with administrative units identified by TERYT codes. The data is published and maintained by GUS, the Polish national statistical office, and can be used for research, planning, and analysis of housing conditions and rent arrears across Polish territorial units.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › ARCHIVAL DATA. Local Data Bank (BDL) subject P1972: 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 code selecting dwelling resource manager/owner category measured.GUS variable id selecting the measured series of subject P1972 (the n1/n2 dimension combination): 409=resources managed by a gmina, dwellings owned by a gmina [person]; 410=resources managed by a gmina, dwellings owned by natural persons [person]; 411=resources managed by other entities, dwellings owned by a gmina [person]. |
| unit_levelUnit level | integer | Territorial aggregation level, from country (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 series.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 identifier.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, e.g. gmina or voivodship.Name of the territorial unit, e.g. gmina or voivodship. |
| teryt_tercTeryt terc | string | TERYT TERC administrative code of 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 | Number of persons with overdue rent in dwelling stock.Number of persons with overdue rent in dwelling stock. |
| 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 |
|---|---|---|---|---|---|---|---|
| 409 | 6 | 1995 | 011212001011 | Bochnia | 1201011 | 436 | 11 |
| 409 | 6 | 1996 | 011212001011 | Bochnia | 1201011 | 433 | 1 |
| 409 | 6 | 1997 | 011212001011 | Bochnia | 1201011 | 363 | 1 |
| 409 | 6 | 1998 | 011212001011 | Bochnia | 1201011 | 459 | 1 |
| 409 | 6 | 1999 | 011212001011 | Bochnia | 1201011 | 472 | 1 |
| 409 | 6 | 2000 | 011212001011 | Bochnia | 1201011 | 534 | 1 |
| 409 | 6 | 2001 | 011212001011 | Bochnia | 1201011 | 109 | 1 |
| 409 | 6 | 1995 | 011212001022 | Bochnia | 1201022 | 0 | 0 |
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/P1972
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/409?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 409 (resources managed by a gmina, dwellings owned by a gmina [person]) 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.