Rental of premises from dwelling stock of gmina and temporary premises
This API provides access to subject P3950 of Statistics Poland's Local Data Bank (BDL), covering rental of premises from municipal (gmina) dwelling stock and temporary premises. It forms part of the Housing Economy and Municipal Infrastructure section, under the Dwelling Stock category. Data are organised as yearly territorial series for Poland, available at multiple administrative levels from voivodship down to gmina, with units identified by TERYT territorial codes. The dataset is maintained by GUS (Statistics Poland), the national statistical office, and is useful for tracking municipal housing provision over time and across regions.”HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › DWELLING STOCK. Local Data Bank (BDL) subject P3950: 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 measured series within subject P3950.GUS variable id selecting the measured series of subject P3950 (the n1/n2 dimension combination): 1612714=rental contracts of premises - existing / premises [-]; 1612715=rental contracts of premises - existing / useful floor area of premises [m2]; 1612716=rental contracts of premises - existing / social rental contracts [-]; 1612717=rental contracts of premises - existing / useful floor area of premises with social rental contracts [m2]; 1612718=rental contracts of premises - concluded / premises [-]; 1612719=rental contracts of premises - concluded / useful floor area of premises [m2]; 1612720=rental contracts of premises - concluded / social rental contracts [-]; 1612721=rental contracts of premises - concluded / useful floor area of premises with social rental contracts [m2]; 1612722=rental contracts of premises - terminated / premises [-]; 1612723=rental contracts of premises - terminated / useful floor area of premises [m2]; 1612724=rental contracts of premises - terminated / social rental contracts [-]; 1612725=rental contracts of premises - terminated / useful floor area of premises with social rental contracts [m2]; 1621955=rental contracts of premises - existing / premises [-]; 1621956=rental contracts of premises - existing / useful floor area of premises [m2]; 1621957=rental contracts of premises - concluded / premises [-]; … (18 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P3950 for the full list). |
| unit_levelUnit level | integer | Territorial aggregation level of the record, from country 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 for 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, e.g. gmina or town.Name of the territorial unit, e.g. gmina or town. |
| teryt_tercTeryt terc | string | TERYT TERC administrative code of the unit derived from 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 | Numeric value of the measured indicator for the unit and year.Numeric value of the measured indicator for the unit and year. |
| attr_idAttr id | integer | GUS attribute code flagging data quality or annotation status.GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 4 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 |
|---|---|---|---|---|---|---|---|
| 1612714 | 6 | 2019 | 011212001011 | Bochnia | 1201011 | 275 | 1 |
| 1612714 | 6 | 2020 | 011212001011 | Bochnia | 1201011 | 257 | 1 |
| 1612714 | 6 | 2021 | 011212001011 | Bochnia | 1201011 | 277 | 1 |
| 1612714 | 6 | 2022 | 011212001011 | Bochnia | 1201011 | 254 | 1 |
| 1612714 | 6 | 2023 | 011212001011 | Bochnia | 1201011 | 237 | 1 |
| 1612714 | 6 | 2024 | 011212001011 | Bochnia | 1201011 | 227 | 1 |
| 1612714 | 6 | 2025 | 011212001011 | Bochnia | 1201011 | 238 | 1 |
| 1612714 | 6 | 2019 | 011212001022 | Bochnia | 1201022 | 6 | 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/P3950
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/1612714?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 1612714 (rental contracts of premises - existing / 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.