Expenditure of gminas and cities with powiat status budgets - Expenditure on communal economy
This API, maintained by Statistics Poland (GUS) as part of the Local Data Bank (Bank Danych Lokalnych, BDL), provides access to subject P2649, covering expenditure of gmina and city-with-powiat-status budgets on communal economy. It offers yearly territorial time series for the whole of Poland, broken down from the voivodship level down to individual gminas, with administrative units identified by TERYT codes. The dataset is part of the archival public finance series within BDL and is intended for statistical and administrative analysis of local government spending on communal services across the country.PUBLIC FINANCE › ARCHIVAL DATA. Local Data Bank (BDL) subject P2649: 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 expenditure measure and gmina category.GUS variable id selecting the measured series of subject P2649 (the n1/n2 dimension combination): 77090=gminas include cities with powiat status / total [PLN]; 77087=gminas include cities with powiat status / current expenditure of budgetary units, total [PLN]; 77084=gminas include cities with powiat status / property expenditure, total [PLN]; 77081=gminas include cities with powiat status / expenditure in chapter 90017 - Establishments of public utility industry [PLN]; 77078=gminas include cities with powiat status / expenditure in chapter 90003 - Cleaning of cities and villages [PLN]; 77075=gminas include cities with powiat status / green areas in urban areas and gminas [PLN]; 77072=gminas include cities with powiat status / streets, squares, bridges and viaducts [PLN]; 77069=gminas include cities with powiat status / street lighting [PLN]; 77066=gminas include cities with powiat status / multisector units of public utility industry [PLN]; 77088=gminas without cities with powiat status / total [PLN]; 77085=gminas without cities with powiat status / current expenditure of budgetary units, total [PLN]; 77082=gminas without cities with powiat status / property expenditure, total [PLN]; 77079=gminas without cities with powiat status / expenditure in chapter 90017 - Establishments of public utility industry [PLN]; 77076=gminas without cities with powiat status / expenditure in chapter 90003 - Cleaning of cities and villages [PLN]; 77073=gminas without cities with powiat status / green areas in urban areas and gminas [PLN]; … (27 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P2649 for the full list). |
| unit_levelUnit level | integer | Territorial aggregation level, from 0 (Poland) to 6 (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 reported 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, such as a gmina or city.Name of the territorial unit, such as a gmina or city. |
| 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 | Reported expenditure value in PLN for the given variable and unit.Reported expenditure value in PLN for the given variable and unit. |
| attr_idAttr id | integer | GUS attribute code flagging data quality or annotation status.GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 6 hours 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 |
|---|---|---|---|---|---|---|---|
| 77090 | 6 | 1995 | 011212001011 | Bochnia | 1201011 | 4355225 | 1 |
| 77090 | 6 | 1996 | 011212001011 | Bochnia | 1201011 | 3684371 | 1 |
| 77090 | 6 | 1997 | 011212001011 | Bochnia | 1201011 | 4114953 | 1 |
| 77090 | 6 | 1998 | 011212001011 | Bochnia | 1201011 | 5238982 | 1 |
| 77090 | 6 | 1999 | 011212001011 | Bochnia | 1201011 | 4239760 | 1 |
| 77090 | 6 | 2000 | 011212001011 | Bochnia | 1201011 | 7490305 | 1 |
| 77090 | 6 | 1995 | 011212001022 | Bochnia | 1201022 | 2069527 | 1 |
| 77090 | 6 | 1996 | 011212001022 | Bochnia | 1201022 | 2867372 | 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/P2649
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/77090?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 77090 (gminas include cities with powiat status / total [PLN]) 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.