Gas supply

APIDiscovered1/7blocked by verifiedQuery nowOpen workbench Subscribe🇵🇱Poland

HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › NETWORK DEVICES. Local Data Bank (BDL) subject P4421: 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 selecting the measured series of subject P4421 (the n1/n2 dimension combination): 1725887=total / length of working network, total in m [m]; 1725888=total / length of working transmission network in m [m]; 1725889=total / length of working distribution network in m [m]; 1725890=total / active connections to residential and non-residential buildings, total [pcs]; 1725891=total / active connections to residential buildings [pcs]; 1725892=total / gas consumers (households), in pcs [pcs]; 1725893=total / gas consumers (households) heating dwellings with gas [pcs]; 1725895=total / household gas consumption total in MWh [MWh]; 1725896=total / household gas consumption for residential heating in MWh [MWh]; 1735578=total / length of working network, total in km per 100 km2 [km]; 1735586=total / gas customers, in million [-]; 1725897=in urban areas / length of working network, total in m [m]; 1725898=in urban areas / length of working transmission network in m [m]; 1725899=in urban areas / length of working distribution network in m [m]; 1725900=in urban areas / active connections to residential and non-residential buildings, total [pcs]; … (29 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P4421 for the full list).
unit_levelUnit level	integer	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 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 id (macroregion+voivodship+region+subregion+powiat+gmina+type digits). An equality filter pins the unit server-side (unit-parent-id).
unit_nameUnit name	string	—
teryt_tercTeryt terc	string	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	—
attr_idAttr id	integer	GUS value-attribute id (data quality/annotation flag).

Schema captured from bdl 6 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_id	unit_name	teryt_terc	value	attr_id
1725887	6	2006	011212001011	Bochnia	1201011	163327	1
1725887	6	2007	011212001011	Bochnia	1201011	163634	1
1725887	6	2008	011212001011	Bochnia	1201011	163703	1
1725887	6	2009	011212001011	Bochnia	1201011	165854	1
1725887	6	2010	011212001011	Bochnia	1201011	168163	1
1725887	6	2011	011212001011	Bochnia	1201011	168033	1
1725887	6	2012	011212001011	Bochnia	1201011	171821	1
1725887	6	2013	011212001011	Bochnia	1201011	145455	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/P4421

License

Creative Commons Attribution 4.0Open

✓ Redistributable
✓ Attribution required

Query examples

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

Yearly values of variable 1725887 (total / length of working network, total in m [m]) 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 ↗