Revenue, total
This API provides access to subject P2621 of Poland's Local Data Bank (Bank Danych Lokalnych, BDL), covering total revenue of gmina and city-with-powiat-status budgets within the broader public finance category. Data is organized as yearly territorial time series, available from the voivodship level down to individual gminas, with units identified by official TERYT territorial codes. It is maintained by Statistics Poland (GUS) and offers free, authentication-free access, supporting analysis of local government revenue trends across Polish administrative divisions over time.PUBLIC FINANCE › REVENUE OF GMINAS AND CITIES WITH POWIAT STATUS BUDGETS. Local Data Bank (BDL) subject P2621: 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 selecting the revenue series variant measured.GUS variable id selecting the measured series of subject P2621 (the n1/n2 dimension combination): 76037=gminas include cities with powiat status / total [PLN]; 76035=gminas without cities with powiat status / total [PLN]; 76036=cities with powiat status / total [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. gmina or voivodship.Name of the territorial unit, e.g. gmina or voivodship. |
| teryt_tercTeryt terc | string | TERYT TERC territorial code derived from the unit identifier.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 | Total revenue value for the unit and year, in PLN.Total revenue value for the unit and year, in PLN. |
| attr_idAttr id | integer | GUS attribute code flagging data quality or annotation status.GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 1 day 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 |
|---|---|---|---|---|---|---|---|
| 76037 | 6 | 1995 | 011212001011 | Bochnia | 1201011 | 14906933 | 1 |
| 76037 | 6 | 1996 | 011212001011 | Bochnia | 1201011 | 18479910 | 1 |
| 76037 | 6 | 1997 | 011212001011 | Bochnia | 1201011 | 21390693 | 1 |
| 76037 | 6 | 1998 | 011212001011 | Bochnia | 1201011 | 27343743 | 1 |
| 76037 | 6 | 1999 | 011212001011 | Bochnia | 1201011 | 30310387 | 1 |
| 76037 | 6 | 2000 | 011212001011 | Bochnia | 1201011 | 34566316 | 1 |
| 76037 | 6 | 2001 | 011212001011 | Bochnia | 1201011 | 39944299 | 1 |
| 76037 | 6 | 2002 | 011212001011 | Bochnia | 1201011 | 38962033 | 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/P2621
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/76037?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 76037 (gminas include cities with powiat status / 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.