Current expenditure of budgetary units

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

This API provides access to subject P1572 of Poland's Local Data Bank (Bank Danych Lokalnych, BDL), covering current expenditure of budgetary units within voivodship budgets under the Public Finance theme. It delivers yearly territorial time series broken down from voivodship down to gmina level, with administrative units identified by TERYT codes. The data is maintained by Statistics Poland (GUS) and can be used for regional and local public finance analysis, comparisons across administrative levels, and monitoring of expenditure trends over time.”PUBLIC FINANCE › EXPENDITURE OF VOIVODSHIPS BUDGETS. Local Data Bank (BDL) subject P1572: 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 specific expenditure measure.GUS variable id selecting the measured series of subject P1572 (the n1/n2 dimension combination): 6479=total [PLN]; 6480=wages and salaries [PLN]; 6481=personal wages and salaries [PLN]; 6482=social security contributions and Labour Fund [PLN]; 77214=social security contributions, Labour Fund and health insurance [PLN].
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 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.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	Reported expenditure value in PLN for the given series.Reported expenditure value in PLN for the given series.
attr_idAttr id	integer	GUS attribute code flagging data quality or annotation.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.

Where=

Sort by

Sample data (8 records)

variable_id	unit_level	year	unit_name	teryt_terc	value	attr_id
6479	—	1999	POLAND	—	1486650683	1
6479	—	2000	POLAND	—	1652857744	1
6479	—	2001	POLAND	—	1755091132	1
6479	—	2002	POLAND	—	1556742863	1
6479	—	2003	POLAND	—	1601908826	1
6479	—	2004	POLAND	—	1782357752	1
6479	—	2005	POLAND	—	2278651691	1
6479	—	2006	POLAND	—	2528325968.21	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/P1572

License

Creative Commons Attribution 4.0Open

✓ Redistributable
✓ Attribution required

Query examples

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

Yearly values of variable 6479 (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.

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.