This API provides access to statistical data on general subvention as part of the revenue of gmina and powiat-status city budgets, published within the Local Data Bank (BDL) maintained by Statistics Poland (GUS). It covers subject group P2623, offering yearly territorial time series from the voivodship down to the gmina level, with administrative units identified by TERYT codes. The dataset supports analysis of local government finance and public revenue distribution across Poland's territorial divisions, and is accessible without authentication as part of the broader BDL API for public finance statistics.PUBLIC FINANCE › REVENUE OF GMINAS AND CITIES WITH POWIAT STATUS BUDGETS. Local Data Bank (BDL) subject P2623: 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 specific general subvention measure.GUS variable id selecting the measured series of subject P2623 (the n1/n2 dimension combination): 77005=gminas include cities with powiat status / grand total [PLN]; 1753074=gminas include cities with powiat status / funds for supplementing LGUs revenue [PLN]; 77002=gminas include cities with powiat status / educational part [PLN]; 76999=gminas include cities with powiat status / supplementing of the general subvention [PLN]; 76996=gminas include cities with powiat status / equalizing part [PLN]; 76993=gminas include cities with powiat status / balancing part [PLN]; 76990=gminas include cities with powiat status / compensatory part [PLN]; 1748896=gminas include cities with powiat status / development part [PLN]; 77003=gminas without cities with powiat status / grand total [PLN]; 1753075=gminas without cities with powiat status / funds for supplementing LGUs revenue [PLN]; 77000=gminas without cities with powiat status / educational part [PLN]; 76997=gminas without cities with powiat status / supplementing of the general subvention [PLN]; 76994=gminas without cities with powiat status / equalizing part [PLN]; 76991=gminas without cities with powiat status / balancing part [PLN]; 76988=gminas without cities with powiat status / compensatory part [PLN]; … (24 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P2623 for the full list). |
| unit_levelUnit level | integer | Territorial aggregation level, from country (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 reported 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 identifier code of 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. gmina or city.Name of the territorial unit, e.g. gmina or city. |
| 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 | Reported value of the subvention measure, in PLN.Reported value of the subvention measure, in PLN. |
| attr_idAttr id | integer | GUS data-quality or annotation flag for the value.GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 5 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 |
|---|---|---|---|---|---|---|---|
| 77005 | 6 | 1995 | 011212001011 | Bochnia | 1201011 | 4274686 | 1 |
| 77005 | 6 | 1996 | 011212001011 | Bochnia | 1201011 | 5205443 | 11 |
| 77005 | 6 | 1997 | 011212001011 | Bochnia | 1201011 | 6166387 | 1 |
| 77005 | 6 | 1998 | 011212001011 | Bochnia | 1201011 | 7447321 | 1 |
| 77005 | 6 | 1999 | 011212001011 | Bochnia | 1201011 | 8206334 | 1 |
| 77005 | 6 | 2000 | 011212001011 | Bochnia | 1201011 | 8374697 | 1 |
| 77005 | 6 | 2001 | 011212001011 | Bochnia | 1201011 | 10990350 | 1 |
| 77005 | 6 | 2002 | 011212001011 | Bochnia | 1201011 | 10446034 | 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/P2623
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/77005?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 77005 (gminas include cities with powiat status / 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.