Gas supply
This API provides access to subject P4421 (Gas supply) within the Local Data Bank (Bank Danych Lokalnych, BDL), maintained by Statistics Poland (GUS). It falls under the housing economy and municipal infrastructure category, specifically network devices, and offers yearly territorial statistical series covering Poland at multiple administrative levels, from voivodship down to gmina. Territorial units are identified using TERYT identifiers, the national register of territorial division codes, enabling consistent linkage with other Polish official statistics and supporting analysis of gas supply infrastructure across regions over time.} Actually I must output pure JSON. Let me redo properly.}{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.
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 measured gas-supply series.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, 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 identifier of the territorial unit.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 code of 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 | Numeric value of the selected gas-supply variable.Numeric value of the selected gas-supply variable. |
| attr_idAttr id | integer | GUS attribute id flagging data quality or annotation.GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 1 day 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 |
|---|---|---|---|---|---|---|---|
| 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
- ✓ 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.
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.