Electricity in households by consumer location
Part of the Local Data Bank (Bank Danych Lokalnych, BDL) maintained by Statistics Poland (GUS), providing yearly territorial statistics on electricity supply to households by consumer location, subject code P1880, within the Housing Economy and Municipal Infrastructure category, Network Devices subcategory. Data are available across administrative levels from voivodship down to gmina, with territorial units identified by TERYT codes. The API allows programmatic access to these time series for national, regional, and local analysis of household electricity network infrastructure across Poland.”HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › NETWORK DEVICES. Local Data Bank (BDL) subject P1880: 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 specific electricity measure and category.GUS variable id selecting the measured series of subject P1880 (the n1/n2 dimension combination): 35309=electricity consumers / total [pcs]; 35311=electricity consumers / in rural areas [pcs]; 35310=consumption of electricity / total [MWh]; 35308=consumption of electricity / in rural areas [MWh]; 288063=consumption of electricity per capita / total [kWh]; 288062=consumption of electricity per capita / in rural areas [kWh]; 1612045=consumption of electricity per consumer / total [kWh]; 1612046=consumption of electricity per consumer / in rural areas [kWh]. |
| unit_levelUnit level | integer | Territorial aggregation level, from Poland-wide 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 yearly 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 code identifying 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 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 | Numeric value of the measured electricity variable.Numeric value of the measured electricity variable. |
| attr_idAttr id | integer | GUS attribute code indicating data quality or annotation flag.GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 7 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 |
|---|---|---|---|---|---|---|---|
| 35309 | — | 2000 | 000000000000 | POLAND | — | 11122643 | 1 |
| 35309 | — | 2001 | 000000000000 | POLAND | — | 11330610 | 1 |
| 35309 | — | 2002 | 000000000000 | POLAND | — | 11437916 | 1 |
| 35309 | — | 2003 | 000000000000 | POLAND | — | 11543925 | 1 |
| 35309 | — | 2004 | 000000000000 | POLAND | — | 11860856 | 1 |
| 35309 | — | 2005 | 000000000000 | POLAND | — | 13648478 | 1 |
| 35309 | — | 2006 | 000000000000 | POLAND | — | 13718349 | 1 |
| 35309 | — | 2007 | 000000000000 | POLAND | — | 13832401 | 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/P1880
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/35309?page-size=10&format=json&lang=en'Yearly values of variable 35309 (electricity consumers / total [pcs]) 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.