Residential buildings connected to technical infrastructure
This API provides access to subject P3585 of Poland's Local Data Bank (Bank Danych Lokalnych, BDL), part of the housing economy and municipal infrastructure category covering network devices. It supplies yearly territorial time series on residential buildings connected to technical infrastructure, spanning national, voivodship and gmina levels, with statistical units identified by TERYT codes, Poland's official territorial division register. The dataset is maintained by the Polish Statistical Office (GUS) and supports comparison of infrastructure connectivity across different administrative levels and over time.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › NETWORK DEVICES. Local Data Bank (BDL) subject P3585: 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 (area/network type) of subject P3585.GUS variable id selecting the measured series of subject P3585 (the n1/n2 dimension combination): 475712=total / water supply system [%]; 475709=total / sewage system [%]; 475713=in urban areas / water supply system [%]; 475710=in urban areas / sewage system [%]; 475714=in rural areas / water supply system [%]; 475711=in rural areas / sewage system [%]. |
| 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 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 reported 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, such as a gmina or powiat.Name of the territorial unit, such as a gmina or powiat. |
| 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 | Reported percentage value of the selected measured series.Reported percentage value of the selected measured series. |
| 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 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 |
|---|---|---|---|---|---|---|---|
| 475712 | 6 | 2015 | 011212001011 | Bochnia | 1201011 | 92.2 | 1 |
| 475712 | 6 | 2016 | 011212001011 | Bochnia | 1201011 | 91.7 | 1 |
| 475712 | 6 | 2017 | 011212001011 | Bochnia | 1201011 | 92 | 1 |
| 475712 | 6 | 2018 | 011212001011 | Bochnia | 1201011 | 90.5 | 1 |
| 475712 | 6 | 2019 | 011212001011 | Bochnia | 1201011 | 90 | 1 |
| 475712 | 6 | 2020 | 011212001011 | Bochnia | 1201011 | 89.1 | 1 |
| 475712 | 6 | 2021 | 011212001011 | Bochnia | 1201011 | 90.1 | 1 |
| 475712 | 6 | 2022 | 011212001011 | Bochnia | 1201011 | 93.5 | 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/P3585
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/475712?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 475712 (total / 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.