Revenue of voivodships budgets

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

Part of Poland's Local Data Bank (Bank Danych Lokalnych, BDL), maintained by the Central Statistical Office (GUS), this API provides subject P1565: yearly territorial time series on the revenue of voivodship-level budgets. Data is organized by territorial units, from voivodship down to gmina level, identified through TERYT registry codes. It falls under the public finance category and offers free, no-authentication access, making it suitable for statistical analysis, research, and public administration monitoring of regional budget revenues across Poland's administrative divisions over time.PUBLIC FINANCE › REVENUE OF VOIVODSHIPS BUDGETS. Local Data Bank (BDL) subject P1565: 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 id selecting the measured series of subject P1565 (the n1/n2 dimension combination): 6454=total [PLN].
unit_levelUnit level	integer	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 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 id (macroregion+voivodship+region+subregion+powiat+gmina+type digits). An equality filter pins the unit server-side (unit-parent-id).
unit_nameUnit name	string	—
teryt_tercTeryt terc	string	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	—
attr_idAttr id	integer	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
6454	—	1999	POLAND	—	3288426613	1
6454	—	2000	POLAND	—	3704626897	1
6454	—	2001	POLAND	—	4599533637	1
6454	—	2002	POLAND	—	4218269361	1
6454	—	2003	POLAND	—	4565749721	1
6454	—	2004	POLAND	—	6970305927	1
6454	—	2005	POLAND	—	7066206256	1
6454	—	2006	POLAND	—	9485847201.2	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/P1565

License

Creative Commons Attribution 4.0Open

✓ Redistributable
✓ Attribution required

Query examples

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

Yearly values of variable 6454 (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 ↗