Households waiting for allocation of rental and temporary housing unitsHouseholds waiting for rental of residential premises and temporary premises
Households waiting for rental of residential premises and temporary premisesHouseholds waiting for allocation of rental and temporary housing units
This API provides access to statistical subject P3952 of the Local Data Bank (Bank Danych Lokalnych, BDL), maintained by the Polish Central Statistical Office (GUS). It covers the category 'Housing economy and municipal infrastructure – Dwelling stock', reporting yearly territorial series on households waiting for allocation of rental housing and temporary premises. Data are available for administrative units across Poland, from voivodship down to gmina level, identified via TERYT territorial codes. The dataset is useful for analyzing housing shortages and demand for social housing across regions and over time.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › DWELLING STOCK. Local Data Bank (BDL) subject P3952: 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 identifying the specific waiting-list rental measure (subject P3952).GUS variable id selecting the measured series of subject P3952 (the n1/n2 dimension combination): 1612780=waiting for rent / residential premises (excluding replacement premises and temporary premises) [-]; 1612781=waiting for rent / social rental contracts [-]; 1612782=waiting for rent / social rental of premises, in the implementation of eviction judgments [-]; 1612783=waiting for rent / temporary premises [-]; 1612784=entered on waiting list for rent / residential premises (excluding replacement premises and temporary premises) [-]; 1612785=entered on waiting list for rent / social rental contracts [-]; 1612786=entered on waiting list for rent / social rental of premises, in the implementation of eviction judgments [-]; 1612787=entered on waiting list for rent / temporary premises [-]; 1612788=removed from waiting list for rent / residential premises (excluding replacement premises and temporary premises) [-]; 1612789=removed from waiting list for rent / social rental contracts [-]; 1612790=removed from waiting list for rent / social rental of premises, in the implementation of eviction judgments [-]; 1612791=removed from waiting list for rent / temporary premises [-]. |
| 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 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 territorial unit identifier for the reporting area.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 powiat.Name of the territorial unit, e.g. gmina or powiat. |
| teryt_tercTeryt terc | string | TERYT TERC code identifying 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 households recorded for the given variable, unit and year.Number of households recorded for the given variable, unit and year. |
| attr_idAttr id | integer | GUS data-quality or annotation flag code for the value.GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 6 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 |
|---|---|---|---|---|---|---|---|
| 1612780 | 6 | 2019 | 011212001011 | Bochnia | 1201011 | 41 | 1 |
| 1612780 | 6 | 2020 | 011212001011 | Bochnia | 1201011 | 24 | 1 |
| 1612780 | 6 | 2021 | 011212001011 | Bochnia | 1201011 | 21 | 1 |
| 1612780 | 6 | 2022 | 011212001011 | Bochnia | 1201011 | 22 | 1 |
| 1612780 | 6 | 2023 | 011212001011 | Bochnia | 1201011 | 21 | 1 |
| 1612780 | 6 | 2024 | 011212001011 | Bochnia | 1201011 | 22 | 1 |
| 1612780 | 6 | 2025 | 011212001011 | Bochnia | 1201011 | 20 | 1 |
| 1612780 | 6 | 2019 | 011212001022 | Bochnia | 1201022 | 3 | 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/P3952
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/1612780?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 1612780 (waiting for rent / residential premises (excluding replacement premises and temporary premises) [-]) 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.