Dwelling stocks of gmina for which costs are calculated
This API provides access to a subject-specific series from Poland's Local Data Bank (Bank Danych Lokalnych, BDL), maintained by the national statistical office GUS. It covers the theme of housing economy and municipal infrastructure, specifically dwelling stock data (subject code P4268), listing gmina-level units for which associated costs are calculated. Data are organized as yearly territorial series, available from the voivodship down to the gmina level, with administrative units identified by TERYT codes. The API is part of the broader BDL system, which offers structured access to official statistics across Poland's administrative hierarchy for research, planning, and public administration purposes.”HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › DWELLING STOCK. Local Data Bank (BDL) subject P4268: 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 which measured series (e.g. residential or business floor area) is used.GUS variable id selecting the measured series of subject P4268 (the n1/n2 dimension combination): 1646467=useful floor area / residential premises [m2]; 1646468=useful floor area / business premises [m2]. |
| unit_levelUnit level | integer | Territorial aggregation level, from 0 (Poland) to 6 (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 yearly 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 combining region and gmina codes.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. the gmina or town.Name of the territorial unit, e.g. the gmina or town. |
| 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 | Measured value of the selected dwelling stock variable.Measured value of the selected dwelling stock variable. |
| attr_idAttr id | integer | GUS attribute id flagging data quality or annotation status of 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 |
|---|---|---|---|---|---|---|---|
| 1646467 | 6 | 2022 | 011212001011 | Bochnia | 1201011 | 11104 | 1 |
| 1646467 | 6 | 2024 | 011212001011 | Bochnia | 1201011 | 11157 | 1 |
| 1646467 | 6 | 2022 | 011212001022 | Bochnia | 1201022 | 284 | 1 |
| 1646467 | 6 | 2024 | 011212001022 | Bochnia | 1201022 | 166 | 1 |
| 1646467 | 6 | 2022 | 011212001032 | Drwinia | 1201032 | 851 | 1 |
| 1646467 | 6 | 2024 | 011212001032 | Drwinia | 1201032 | 1232 | 1 |
| 1646467 | 6 | 2022 | 011212001042 | Lipnica Murowana | 1201042 | 1256 | 1 |
| 1646467 | 6 | 2024 | 011212001042 | Lipnica Murowana | 1201042 | 1237 | 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/P4268
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/1646467?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 1646467 (useful floor area / residential premises [m2]) 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.