Heating system management - Cubic volume of buildings with central heating by location

APIExecutable4/7Query nowOpen workbench Subscribe🇵🇱Poland

HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › ARCHIVAL DATA. Local Data Bank (BDL) subject P3543: yearly territorial series for Poland (voivodship to gmina level), units keyed by TERYT ids.

Values of one variable across territorial units Documentation Open source record

Data schema (8 fields)

Click a field to see example values.

Field	Type	Description
variable_idVariable id	string	GUS variable id identifying the measured series (area type and building ownership category).GUS variable id selecting the measured series of subject P3543 (the n1/n2 dimension combination): 461726=total / total [dam3]; 461725=total / residential buildings, grand total [dam3]; 461724=total / municipal residential buildings [dam3]; 461723=total / housing cooperatives residential buildings [dam3]; 461722=total / private residential buildings [dam3]; 458747=in urban areas / total [dam3]; 458745=in urban areas / residential buildings, grand total [dam3]; 458743=in urban areas / municipal residential buildings [dam3]; 458741=in urban areas / housing cooperatives residential buildings [dam3]; 458739=in urban areas / private residential buildings [dam3]; 458748=in rural areas / total [dam3]; 458746=in rural areas / residential buildings, grand total [dam3]; 458744=in rural areas / municipal residential buildings [dam3]; 458742=in rural areas / housing cooperatives residential buildings [dam3]; 458740=in rural areas / private residential buildings [dam3].
unit_levelUnit level	integer	Territorial aggregation level, from national down to gmina.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 for the location.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 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	Cubic volume of buildings with central heating, in cubic decameters.Cubic volume of buildings with central heating, in cubic decameters.
attr_idAttr id	integer	GUS attribute code flagging data quality or annotation 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.

Where=

Sort by

Sample data (8 records)

variable_id	unit_level	year	unit_name	teryt_terc	value	attr_id
461726	—	1999	POLAND	—	1536783	3
461726	—	2000	POLAND	—	1532219	3
461726	—	2001	POLAND	—	2435781	3
461726	—	2002	POLAND	—	1855288	3
461726	—	2003	POLAND	—	1758756.4	3
461726	—	2004	POLAND	—	1703337.3	3
461726	—	2005	POLAND	—	1745426.9	3
461726	—	2006	POLAND	—	1785176	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/P3543

License

Creative Commons Attribution 4.0Open

✓ Redistributable
✓ Attribution required

Query examples

curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/461726?page-size=10&format=json&lang=en'

Yearly values of variable 461726 (total / total [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.

Full API documentation ↗