Renovation and Modernization in Municipal Housing Stock – Newly Connected InstallationsRenovation and modernization in municipal dwelling stock - Installations newly fed/connected to dwellings
Renovation and modernization in municipal dwelling stock - Installations newly fed/connected to dwellingsRenovation and Modernization in Municipal Housing Stock – Newly Connected Installations
This API provides access to the Local Data Bank (BDL) subject P1741, published by the Polish Central Statistical Office (GUS), covering housing economy and municipal infrastructure under archival data. It offers yearly territorial time series on installations newly fed or connected to dwellings within the municipal housing stock, as part of renovation and modernization statistics. Data are available for territorial units across Poland, from voivodship down to gmina level, identified using TERYT territorial unit codes. The API allows free, unauthenticated programmatic access to these statistical series for research, analysis, or integration into other applications concerning national housing infrastructure trends over time.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › ARCHIVAL DATA. Local Data Bank (BDL) subject P1741: 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 indicator and category of subject P1741.GUS variable id selecting the measured series of subject P1741 (the n1/n2 dimension combination): 447=buildings / total [-]; 448=buildings / water supply system [-]; 449=buildings / sewage system [-]; 450=buildings / central heating [-]; 451=buildings / hot water [-]; 452=buildings / gas from gas supply system [-]; 453=dwellings directly affected by renovation / total [-]; 454=dwellings directly affected by renovation / water supply system [-]; 455=dwellings directly affected by renovation / sewage system [-]; 456=dwellings directly affected by renovation / central heating [-]; 457=dwellings directly affected by renovation / hot water [-]; 458=dwellings directly affected by renovation / gas from gas supply system [-]. |
| 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 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 identifier of 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.Name of the territorial unit. |
| teryt_tercTeryt terc | string | TERYT TERC code of the territorial 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 given unit and year.Numeric value of the measured indicator for the given 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 5 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 |
|---|---|---|---|---|---|---|---|
| 447 | 6 | 1995 | 011212001011 | Bochnia | 1201011 | 2 | 1 |
| 447 | 6 | 1996 | 011212001011 | Bochnia | 1201011 | 0 | 0 |
| 447 | 6 | 1997 | 011212001011 | Bochnia | 1201011 | 0 | 0 |
| 447 | 6 | 1998 | 011212001011 | Bochnia | 1201011 | 0 | 0 |
| 447 | 6 | 1999 | 011212001011 | Bochnia | 1201011 | 0 | 0 |
| 447 | 6 | 2000 | 011212001011 | Bochnia | 1201011 | 0 | 0 |
| 447 | 6 | 2001 | 011212001011 | Bochnia | 1201011 | 0 | 0 |
| 447 | 6 | 1995 | 011212001022 | Bochnia | 1201022 | 0 | 0 |
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/P1741
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/447?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 447 (buildings / total [-]) 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.