Part of Poland's Local Data Bank (BDL), maintained by the national statistical office GUS, this API provides data on public finance subject P2627: revenue per capita of gmina and city budgets (including cities with powiat status). It offers yearly territorial time series covering administrative levels from voivodship down to gmina, with units identified by TERYT codes. The data supports analysis of local government finances and regional comparisons of municipal revenue across Poland, and can be accessed programmatically via the BDL API without authentication.PUBLIC FINANCE › REVENUE OF GMINAS AND CITIES WITH POWIAT STATUS BUDGETS. Local Data Bank (BDL) subject P2627: 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 revenue measure and unit type.GUS variable id selecting the measured series of subject P2627 (the n1/n2 dimension combination): 76973=gminas include cities with powiat status / grand total [PLN]; 76976=gminas include cities with powiat status / own revenue [PLN]; 76979=gminas include cities with powiat status / share in income from taxes comprising state budget revenue, total [PLN]; 149128=gminas include cities with powiat status / own revenue - share in income from taxes comprising state budget revenue - personal income tax [PLN]; 149131=gminas include cities with powiat status / own revenue - share in income from taxes comprising state budget revenue - corporate income tax [PLN]; 76982=gminas include cities with powiat status / own revenue - income tax determined and levied on the basis of separate acts [PLN]; 76975=gminas without cities with powiat status / grand total [PLN]; 76978=gminas without cities with powiat status / own revenue [PLN]; 76981=gminas without cities with powiat status / share in income from taxes comprising state budget revenue, total [PLN]; 149130=gminas without cities with powiat status / own revenue - share in income from taxes comprising state budget revenue - personal income tax [PLN]; 149133=gminas without cities with powiat status / own revenue - share in income from taxes comprising state budget revenue - corporate income tax [PLN]; 76984=gminas without cities with powiat status / own revenue - income tax determined and levied on the basis of separate acts [PLN]; 76974=cities with powiat status / grand total [PLN]; 76977=cities with powiat status / own revenue [PLN]; 76980=cities with powiat status / share in income from taxes comprising state budget revenue, total [PLN]; … (18 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P2627 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 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 for 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 | Recorded revenue value in PLN for the given variable and unit.Recorded revenue value in PLN for the given variable and unit. |
| attr_idAttr id | integer | GUS attribute id flagging data quality or annotation status.GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 3 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 |
|---|---|---|---|---|---|---|---|
| 76973 | 6 | 2002 | 011212001011 | Bochnia | 1201011 | 1326 | 1 |
| 76973 | 6 | 2003 | 011212001011 | Bochnia | 1201011 | 1377 | 1 |
| 76973 | 6 | 2004 | 011212001011 | Bochnia | 1201011 | 1558 | 1 |
| 76973 | 6 | 2005 | 011212001011 | Bochnia | 1201011 | 1663 | 1 |
| 76973 | 6 | 2006 | 011212001011 | Bochnia | 1201011 | 1891.95 | 1 |
| 76973 | 6 | 2007 | 011212001011 | Bochnia | 1201011 | 2179.21 | 1 |
| 76973 | 6 | 2008 | 011212001011 | Bochnia | 1201011 | 2470.12 | 1 |
| 76973 | 6 | 2009 | 011212001011 | Bochnia | 1201011 | 2545.06 | 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/P2627
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/76973?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 76973 (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.