This API provides access to subject P2412 of Poland's Local Data Bank (Bank Danych Lokalnych, BDL), maintained by Statistics Poland (GUS). It contains yearly territorial time series on voivodship budget revenue, expressed per capita, covering administrative units from the voivodship down to the gmina level. Units are identified using official TERYT territorial codes, allowing integration with other geocoded statistical datasets. The data falls under the public finance category and specifically tracks revenue of voivodship budgets, supporting comparative analysis of regional fiscal capacity across Poland over time.”PUBLIC FINANCE › REVENUE OF VOIVODSHIPS BUDGETS. Local Data Bank (BDL) subject P2412: 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 selecting the measured revenue series within subject P2412.GUS variable id selecting the measured series of subject P2412 (the n1/n2 dimension combination): 60508=grand total [PLN]; 60509=own revenue [PLN]; 149138=own revenue - share in income from taxes comprising state budget revenue - personal income tax [PLN]; 149137=own revenue - share in income from taxes comprising state budget revenue - corporate income tax [PLN]. |
| 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 yearly 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.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. voivodship or gmina.Name of the territorial unit, e.g. voivodship or gmina. |
| teryt_tercTeryt terc | string | TERYT TERC territorial code corresponding to the 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 | Revenue per capita value for the given unit, year and variable.Revenue per capita value for the given unit, year and variable. |
| attr_idAttr id | integer | GUS data quality/annotation flag attached to 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 |
|---|---|---|---|---|---|---|---|
| 60508 | — | 2002 | 000000000000 | POLAND | — | 110 | 1 |
| 60508 | — | 2003 | 000000000000 | POLAND | — | 120 | 1 |
| 60508 | — | 2004 | 000000000000 | POLAND | — | 183 | 1 |
| 60508 | — | 2005 | 000000000000 | POLAND | — | 185 | 1 |
| 60508 | — | 2006 | 000000000000 | POLAND | — | 248.76 | 1 |
| 60508 | — | 2007 | 000000000000 | POLAND | — | 297.75 | 1 |
| 60508 | — | 2008 | 000000000000 | POLAND | — | 332.15 | 1 |
| 60508 | — | 2009 | 000000000000 | POLAND | — | 512.36 | 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/P2412
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/60508?page-size=10&format=json&lang=en'Yearly values of variable 60508 (grand 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.