Housing resources of communes (communal), technical and sanitary equipment
This API provides access to subject P4050 of Poland's Local Data Bank (Bank Danych Lokalnych, BDL), maintained by the national statistical office GUS. It covers housing resources of communes, focusing on dwelling stock together with its technical and sanitary equipment, such as water supply, sewage, gas, and heating installations. Data are organized as yearly territorial time series, available at multiple administrative levels from voivodship down to gmina (commune), with each unit identified by its TERYT territorial code. The dataset supports analysis of housing conditions and municipal infrastructure across Poland's regions over time, and is part of the broader housing economy and municipal infrastructure section of the Local Data Bank.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › DWELLING STOCK. Local Data Bank (BDL) subject P4050: 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 measured dwelling-equipment series.GUS variable id selecting the measured series of subject P4050 (the n1/n2 dimension combination): 1621481=dwellings, total / equipped with water supply system [-]; 1621482=dwellings, total / equipped with sewage system [-]; 1621483=dwellings, total / equipped with central heating [-]; 1621484=residential premises, with social rental agreements / equipped with water supply system [-]; 1621485=residential premises, with social rental agreements / equipped with sewage system [-]; 1621486=residential premises, with social rental agreements / equipped with central heating [-]. |
| unit_levelUnit level | integer | Territorial aggregation level, from country (0) 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 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 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.Name of the territorial unit. |
| 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 | Numeric value of the measured indicator for the series.Numeric value of the measured indicator for the series. |
| attr_idAttr id | integer | GUS attribute code flagging data quality or annotation.GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 7 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 |
|---|---|---|---|---|---|---|---|
| 1621481 | 6 | 2020 | 011212001011 | Bochnia | 1201011 | 376 | 1 |
| 1621481 | 6 | 2022 | 011212001011 | Bochnia | 1201011 | 348 | 1 |
| 1621481 | 6 | 2023 | 011212001011 | Bochnia | 1201011 | 348 | 1 |
| 1621481 | 6 | 2024 | 011212001011 | Bochnia | 1201011 | 348 | 1 |
| 1621481 | 6 | 2025 | 011212001011 | Bochnia | 1201011 | 348 | 1 |
| 1621481 | 6 | 2020 | 011212001022 | Bochnia | 1201022 | 6 | 1 |
| 1621481 | 6 | 2022 | 011212001022 | Bochnia | 1201022 | 6 | 1 |
| 1621481 | 6 | 2023 | 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/P4050
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/1621481?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 1621481 (dwellings, total / equipped with water supply system [-]) 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.