Costs of dwelling stock maintenance per 1 m2 of useful floor area in buildings with dwellings
This API provides access to subject P3958 of the Local Data Bank (Bank Danych Lokalnych, BDL), maintained by Statistics Poland (GUS), covering costs of dwelling stock maintenance per 1 m2 of useful floor area in buildings with dwellings. It offers yearly territorial time series under the category Housing Economy and Municipal Infrastructure, disaggregated from the voivodship down to the gmina level, with administrative units identified by TERYT codes. The data supports analysis of housing maintenance costs across Polish territorial units and over time, and can be accessed programmatically without authentication.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › COSTS OF DWELLING STOCK MAINTENANCE. Local Data Bank (BDL) subject P3958: 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 cost measure and stock type.GUS variable id selecting the measured series of subject P3958 (the n1/n2 dimension combination): 1612952=gmina (municipal) stocks / total (including costs of central heating and hot water) [PLN/m2]; 1612953=gmina (municipal) stocks / total (excluding costs of central heating and hot water) [PLN/m2]; 1612954=gmina (municipal) stocks / operational costs total [PLN/m2]; 1612955=gmina (municipal) stocks / operational costs - administration [PLN/m2]; 1612956=gmina (municipal) stocks / operational costs - maintenance and renovation [PLN/m2]; 1612957=gmina (municipal) stocks / costs of provided services total (including costs of central heating and hot water) [PLN/m2]; 1612958=gmina (municipal) stocks / costs of provided services total (excluding costs of central heating and hot water) [PLN/m2]; 1612959=gmina (municipal) stocks / costs of provided services - central heating and hot water [PLN/m2]; 1612960=companies stocks / total (including costs of central heating and hot water) [PLN/m2]; 1612961=companies stocks / total (excluding costs of central heating and hot water) [PLN/m2]; 1612962=companies stocks / operational costs total [PLN/m2]; 1612963=companies stocks / operational costs - administration [PLN/m2]; 1612964=companies stocks / operational costs - maintenance and renovation [PLN/m2]; 1612965=companies stocks / costs of provided services total (including costs of central heating and hot water) [PLN/m2]; 1612966=companies stocks / costs of provided services total (excluding costs of central heating and hot water) [PLN/m2]; … (56 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P3958 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 reported 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 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 maintenance cost value in PLN per square metre.Reported maintenance cost value in PLN per square metre. |
| attr_idAttr id | integer | GUS attribute id 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 |
|---|---|---|---|---|---|---|---|
| 1612952 | — | 2018 | 000000000000 | POLAND | — | 127.44 | 1 |
| 1612952 | — | 2020 | 000000000000 | POLAND | — | 150.64 | 1 |
| 1612952 | — | 2022 | 000000000000 | POLAND | — | 174.5 | 1 |
| 1612952 | — | 2024 | 000000000000 | POLAND | — | 198.13 | 1 |
| 1612952 | — | 2018 | 010000000000 | MACROREGION POŁUDNIOWY | — | 137.02 | 1 |
| 1612952 | — | 2020 | 010000000000 | MACROREGION POŁUDNIOWY | — | 169.16 | 1 |
| 1612952 | — | 2022 | 010000000000 | MACROREGION POŁUDNIOWY | — | 193.15 | 1 |
| 1612952 | — | 2024 | 010000000000 | MACROREGION POŁUDNIOWY | — | 200.78 | 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/P3958
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/1612952?page-size=10&format=json&lang=en'Yearly values of variable 1612952 (gmina (municipal) stocks / total (including costs of central heating and hot water) [PLN/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.