Water supply systems
This API provides access to subject P1600 of Poland's Local Data Bank (Bank Danych Lokalnych, BDL), covering water supply systems under the housing economy and municipal infrastructure category, specifically network devices. It offers yearly territorial time series data spanning administrative levels from voivodship down to gmina, with units identified by TERYT territorial identifiers. The data is maintained by GUS, Poland's national statistical office, and is freely accessible without authentication, supporting national, regional and local analysis of water infrastructure across the country.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › NETWORK DEVICES. Local Data Bank (BDL) subject P1600: 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 water-supply metric of subject P1600 is measured.GUS variable id selecting the measured series of subject P1600 (the n1/n2 dimension combination): 1612162=length of the exploited water network (distribution and transmition) [km]; 489=length of working distribution network [km]; 8896=length of active distribution water network administrated by the gmina [km]; 8897=length of active distribution water network administrated by the gmina, including network operated by public utility entities [km]; 490=connections leading to residential buildings and collective accomodation facilities [pcs]; 475705=water supply network breakdowns [pcs]; 1612163=water supplied [dam3]; 491=water supplied to households [dam3]; 1612164=street outlets [pcs]; 396249=consumption of water in households per capita [m3]; 396248=consumption of water in households in urban area per capita [m3]; 396250=consumption of water in households in rural area per capita [m3]; 493=dwellings in residential buildings newly connected to water network [-]; 492=population using the water supply system in urban areas [person]; 9152=population using the water supply system [person]; … (29 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P1600 for the full list). |
| 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.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. town or gmina.Name of the territorial unit, e.g. town or gmina. |
| teryt_tercTeryt terc | string | TERYT TERC 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 | Measured value of the selected water-supply variable.Measured value of the selected water-supply variable. |
| 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 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 |
|---|---|---|---|---|---|---|---|
| 1612162 | 6 | 2020 | 011212001011 | Bochnia | 1201011 | 99.6 | 1 |
| 1612162 | 6 | 2021 | 011212001011 | Bochnia | 1201011 | 100.4 | 1 |
| 1612162 | 6 | 2022 | 011212001011 | Bochnia | 1201011 | 100.4 | 1 |
| 1612162 | 6 | 2023 | 011212001011 | Bochnia | 1201011 | 100.4 | 1 |
| 1612162 | 6 | 2024 | 011212001011 | Bochnia | 1201011 | 104.2 | 1 |
| 1612162 | 6 | 2025 | 011212001011 | Bochnia | 1201011 | 104.3 | 1 |
| 1612162 | 6 | 2020 | 011212001022 | Bochnia | 1201022 | 253.3 | 1 |
| 1612162 | 6 | 2021 | 011212001022 | Bochnia | 1201022 | 255.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/P1600
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/1612162?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 1612162 (length of the exploited water network (distribution and transmition) [km]) 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.