Part of Poland's Local Data Bank (BDL), maintained by GUS (Statistics Poland), this API provides subject P2923 covering public finance data on revenue to voivodship budgets, broken down by division. It offers yearly territorial time series for administrative units ranging from voivodship down to gmina level, identified using TERYT codes. The data supports analysis of regional government revenue structures across Poland and is accessible without authentication for integration into statistical or research applications.PUBLIC FINANCE › REVENUE OF VOIVODSHIPS BUDGETS. Local Data Bank (BDL) subject P2923: 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 id identifying the revenue division measured (total or specific sector, in PLN).GUS variable id selecting the measured series of subject P2923 (the n1/n2 dimension combination): 1548650=total [PLN]; 202508=Division 010 - Agriculture and hunting [PLN]; 202510=Division 020 - Forestry [PLN]; 202507=Division 050 - Fisheries and fishing [PLN]; 202506=Division 100 - Mining and quarrying [PLN]; 202505=Division 150 - Manufacturing [PLN]; 202504=Division 400 - Electricity, gas and water supply [PLN]; 202503=Division 500 - Trade [PLN]; 202502=Division 550 - Hotels and restaurants [PLN]; 202501=Division 600 - Transport and communication [PLN]; 202500=Division 630 - Tourism [PLN]; 202499=Division 700 - Housing economy [PLN]; 202498=Division 710 - Service activities [PLN]; 202497=Division 720 - Information Technology [PLN]; 202496=Division 730 - Science [PLN]; … (37 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P2923 for the full list). |
| unit_levelUnit level | integer | Territorial aggregation level, from Poland (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 revenue 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 for the area.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 (e.g. country, voivodship, gmina).Name of the territorial unit (e.g. country, voivodship, gmina). |
| teryt_tercTeryt terc | string | TERYT TERC code of the territorial unit, derived from unit id.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 | Revenue amount for the given division, year and unit, in PLN.Revenue amount for the given division, year and unit, in PLN. |
| attr_idAttr id | integer | GUS data-quality attribute flag for the value.GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 6 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 |
|---|---|---|---|---|---|---|---|
| 1548650 | — | 2010 | 000000000000 | POLAND | — | 14104017367.88 | 1 |
| 1548650 | — | 2011 | 000000000000 | POLAND | — | 15067097945.36 | 1 |
| 1548650 | — | 2012 | 000000000000 | POLAND | — | 15236090790.2 | 1 |
| 1548650 | — | 2013 | 000000000000 | POLAND | — | 16120716965.57 | 1 |
| 1548650 | — | 2014 | 000000000000 | POLAND | — | 17745621590.04 | 1 |
| 1548650 | — | 2015 | 000000000000 | POLAND | — | 17110133814.56 | 1 |
| 1548650 | — | 2016 | 000000000000 | POLAND | — | 13505630248.47 | 1 |
| 1548650 | — | 2017 | 000000000000 | POLAND | — | 14771385011.99 | 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/P2923
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/1548650?page-size=10&format=json&lang=en'Yearly values of variable 1548650 (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.