Heating system management - Sale of heating energy per cubic volume of residential buildings
Part of Poland's Local Data Bank (Bank Danych Lokalnych, BDL), subject group P3529 within Housing Economy and Municipal Infrastructure (archival data), covering the sale of heating energy per cubic volume of residential buildings. The API provides yearly territorial time series from voivodship down to gmina level, with administrative units identified by TERYT codes. It is published and maintained by GUS, the Polish national statistical office, and can be accessed programmatically without authentication for research, planning, or statistical analysis of local heating infrastructure and energy consumption patterns across Poland.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › ARCHIVAL DATA. Local Data Bank (BDL) subject P3529: 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 heating energy sale measure.GUS variable id selecting the measured series of subject P3529 (the n1/n2 dimension combination): 458595=total [GJ/dam3]; 469435=Sale of heating energy per cubic volume of residential buildings with central heating in urban areas [GJ/dam3]; 469434=Sale of heating energy per cubic volume of residential buildings with central heating in rural areas [GJ/dam3]. |
| unit_levelUnit level | integer | Territorial aggregation level, from Poland (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 for 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.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 | Measured value of heating energy sold per cubic volume, in GJ/dam3.Measured value of heating energy sold per cubic volume, in GJ/dam3. |
| attr_idAttr id | integer | GUS attribute code flagging data quality or annotation.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 |
|---|---|---|---|---|---|---|---|
| 458595 | — | 2003 | 000000000000 | POLAND | — | 187.73 | 3 |
| 458595 | — | 2004 | 000000000000 | POLAND | — | 171.52 | 3 |
| 458595 | — | 2005 | 000000000000 | POLAND | — | 159.88 | 3 |
| 458595 | — | 2006 | 000000000000 | POLAND | — | 161.62 | 3 |
| 458595 | — | 2007 | 000000000000 | POLAND | — | 151.25 | 3 |
| 458595 | — | 2008 | 000000000000 | POLAND | — | 159.8 | 3 |
| 458595 | — | 2009 | 000000000000 | POLAND | — | 152.24 | 3 |
| 458595 | — | 2010 | 000000000000 | POLAND | — | 160.12 | 3 |
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/P3529
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/458595?page-size=10&format=json&lang=en'Yearly values of variable 458595 (total [GJ/dam3]) 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.