Heating – Sale of heating energy during the year by energy sourceHeating -Sale of heating energy during the year by energy source
Heating -Sale of heating energy during the year by energy sourceHeating – Sale of heating energy during the year by energy source
This API provides access to subject P1606 of Poland's Local Data Bank (Bank Danych Lokalnych, BDL), maintained by Statistics Poland (GUS). It covers yearly territorial statistics on the sale of heating energy by energy source, falling under the housing economy and municipal infrastructure category, specifically archival data. Figures are available at multiple territorial levels, from voivodship down to gmina, with units identified using official TERYT territorial codes. The dataset supports analysis of regional heating energy supply trends across Poland over time, and is accessible free of charge without authentication.”},HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › ARCHIVAL DATA. Local Data Bank (BDL) subject P1606: 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 heating energy sale measure (source and purpose).GUS variable id selecting the measured series of subject P1606 (the n1/n2 dimension combination): 3424=from own boiler houses to clients, grand total [GJ]; 3425=from own boiler houses for community needs [GJ]; 3426=from outside sources to clients, grand total [GJ]; 3427=from outside sources for community needs [GJ]. |
| 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 territorial unit identifier encoding the administrative hierarchy.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. country, voivodship or gmina.Name of the territorial unit, e.g. country, voivodship or gmina. |
| teryt_tercTeryt terc | string | TERYT TERC administrative code derived from the 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 | Sold heating energy amount for the given source and year, in GJ.Sold heating energy amount for the given source and year, in GJ. |
| attr_idAttr id | integer | GUS data quality or annotation flag code for the value.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 |
|---|---|---|---|---|---|---|---|
| 3424 | — | 1999 | 000000000000 | POLAND | — | 147000250 | 1 |
| 3424 | — | 2000 | 000000000000 | POLAND | — | 135489801 | 1 |
| 3424 | — | 1999 | 010000000000 | MACROREGION POŁUDNIOWY | — | 35029019 | 1 |
| 3424 | — | 2000 | 010000000000 | MACROREGION POŁUDNIOWY | — | 32060798 | 1 |
| 3424 | — | 1999 | 011200000000 | MAŁOPOLSKIE | 12 | 5454277 | 1 |
| 3424 | — | 2000 | 011200000000 | MAŁOPOLSKIE | 12 | 5252900 | 1 |
| 3424 | — | 1999 | 011210000000 | REGION MAŁOPOLSKIE | — | 5454277 | 1 |
| 3424 | — | 2000 | 011210000000 | REGION MAŁOPOLSKIE | — | 5252900 | 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/P1606
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/3424?page-size=10&format=json&lang=en'Yearly values of variable 3424 (from own boiler houses to clients, grand total [GJ]) 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.