This API provides access to subject P1570 of Poland's Local Data Bank (Bank Danych Lokalnych, BDL), covering public finance data on revenue of voivodship budgets classified as grants. It offers yearly territorial statistical series spanning administrative levels from voivodship down to gmina, with units identified by TERYT codes. The data is maintained by GUS, Poland's national statistical office, and forms part of the broader BDL API providing nationwide, long-term local and regional statistics. It is accessible without authentication and is useful for analyzing regional public finance trends across Polish administrative units over time.PUBLIC FINANCE › REVENUE OF VOIVODSHIPS BUDGETS. Local Data Bank (BDL) subject P1570: 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 code identifying the specific grant measure and series.GUS variable id selecting the measured series of subject P1570 (the n1/n2 dimension combination): 151817=grants, total (targeted + grants §§ 200, 620 + grants §§ 205, 625) / total [PLN]; 151815=grants, total (targeted + grants §§ 200, 620 + grants §§ 205, 625) / investment [PLN]; 101528=targeted grants / total [PLN]; 6464=targeted grants from the state budget / total [PLN]; 149188=targeted grants from the state budget / investment [PLN]; 6465=targeted grants from the state budget for government administration tasks / total [PLN]; 6466=targeted grants from the state budget for government administration tasks / investment [PLN]; 6467=targeted grants from the state budget for own tasks / total [PLN]; 6468=targeted grants from the state budget for own tasks / investment [PLN]; 6469=targeted grants from the state budget for tasks carried out on the basis of agreements with government administration bodies / total [PLN]; 6470=targeted grants from the state budget for tasks carried out on the basis of agreements with government administration bodies / investment [PLN]; 6471=targeted grants for tasks realized on the basis of agreements between local government units / total [PLN]; 6472=targeted grants for tasks realized on the basis of agreements between local government units / investment [PLN]; 6473=grants received from appropriated funds / total [PLN]; 6474=grants received from appropriated funds / investment [PLN]; … (25 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P1570 for the full list). |
| unit_levelUnit level | integer | Territorial aggregation level, from country down to 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 code identifying the territorial unit.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 administrative code derived from the 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 | Numeric value of the grant measure in PLN.Numeric value of the grant measure in PLN. |
| attr_idAttr id | integer | GUS attribute code flagging data quality or annotation.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 |
|---|---|---|---|---|---|---|---|
| 151817 | — | 2009 | 000000000000 | POLAND | — | 10441676617.02 | 1 |
| 151817 | — | 2010 | 000000000000 | POLAND | — | 5459145360.17 | 1 |
| 151817 | — | 2011 | 000000000000 | POLAND | — | 5895477473.36 | 1 |
| 151817 | — | 2012 | 000000000000 | POLAND | — | 6180681362.8 | 1 |
| 151817 | — | 2013 | 000000000000 | POLAND | — | 7178383311.99 | 1 |
| 151817 | — | 2014 | 000000000000 | POLAND | — | 8329569409.98 | 1 |
| 151817 | — | 2015 | 000000000000 | POLAND | — | 7962024307.76 | 1 |
| 151817 | — | 2016 | 000000000000 | POLAND | — | 4335330014.54 | 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/P1570
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/151817?page-size=10&format=json&lang=en'Yearly values of variable 151817 (grants, total (targeted + grants §§ 200, 620 + grants §§ 205, 625) / 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.