Population using gas supply system

APIJoinable5/7Query nowOpen workbench Subscribe🇵🇱Poland

This API provides access to statistical series on the population using the gas supply system, part of the Local Data Bank (Bank Danych Lokalnych, BDL) subject group covering housing economy and municipal infrastructure network devices. Maintained by GUS Poland, the national statistical office, it offers yearly territorial data for Poland disaggregated from voivodship down to gmina level, with units identified by TERYT territorial identifiers. It is useful for analysing regional infrastructure coverage and access to gas networks across Polish administrative units over time.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › NETWORK DEVICES. Local Data Bank (BDL) subject P4565: 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 code identifying the series: total, urban, or rural population.GUS variable id selecting the measured series of subject P4565 (the n1/n2 dimension combination): 1735591=total [person]; 1735592=in urban areas [person]; 1735593=in rural areas [person].
unit_levelUnit level	integer	Territorial aggregation level, from country (0) 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 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	Number of people using the gas supply system.Number of people using the gas supply system.
attr_idAttr id	integer	GUS data quality/annotation flag for the value.GUS value-attribute id (data quality/annotation flag).

Schema captured from bdl 4 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
1735591	6	2002	011212001011	Bochnia	1201011	26762	1
1735591	6	2003	011212001011	Bochnia	1201011	28836	1
1735591	6	2004	011212001011	Bochnia	1201011	26635	1
1735591	6	2005	011212001011	Bochnia	1201011	26620	1
1735591	6	2006	011212001011	Bochnia	1201011	26380	1
1735591	6	2007	011212001011	Bochnia	1201011	26423	1
1735591	6	2008	011212001011	Bochnia	1201011	26582	1
1735591	6	2009	011212001011	Bochnia	1201011	26736	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/P4565

License

Creative Commons Attribution 4.0Open

✓ Redistributable
✓ Attribution required

Query examples

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

Yearly values of variable 1735591 (total [person]) 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 ↗

Machine-readable & source

JSON

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.