Share of own revenues of budget of cities with powiat status in own revenues of budget of gminas and cities with powiat status

APIExecutable4/7Query nowOpen workbench Subscribe🇵🇱Poland

This API provides access to subject P3811 of Poland's Local Data Bank (Bank Danych Lokalnych, BDL), maintained by GUS, the Polish national statistical office. It delivers yearly territorial series on the share of own revenues of cities with powiat (county) status within the combined own revenues of gminas and cities with powiat status, part of the broader public finance category covering revenue and expenditure indicators of local government units. Data are available at levels from voivodship down to gmina, with territorial units identified using TERYT codes, supporting analysis of local government finance across Poland.PUBLIC FINANCE › REVENUE AND EXPENDITURE OF LOCAL GOVERNMENT UNITS (LGUs) - INDICATORS. Local Data Bank (BDL) subject P3811: 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 measured series, e.g. 744972=total share [%].GUS variable id selecting the measured series of subject P3811 (the n1/n2 dimension combination): 744972=total [%].
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 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 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 administrative 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	Share of own revenues of city-with-powiat-status budgets, in percent.Share of own revenues of city-with-powiat-status budgets, in percent.
attr_idAttr id	integer	GUS data quality/annotation flag for the value.GUS value-attribute id (data quality/annotation flag).

Schema captured from bdl 5 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.

Where=

Sort by

Sample data (8 records)

variable_id	unit_level	year	unit_name	teryt_terc	value	attr_id
744972	—	2010	POLAND	—	51.5	1
744972	—	2011	POLAND	—	27.1	1
744972	—	2012	POLAND	—	50.6	1
744972	—	2013	POLAND	—	51	1
744972	—	2014	POLAND	—	50.7	1
744972	—	2015	POLAND	—	50.7	1
744972	—	2016	POLAND	—	50.4	1
744972	—	2017	POLAND	—	50.1	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/P3811

License

Creative Commons Attribution 4.0Open

✓ Redistributable
✓ Attribution required

Query examples

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

Yearly values of variable 744972 (total [%]) 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.