This API provides access to subject P2638 of Poland's Local Data Bank (BDL), covering yearly territorial series on public finance, specifically expenditure in Division 801 (Education) from the budgets of gminas and cities with powiat status. Data are available at multiple territorial levels, from voivodship down to gmina, with units identified by TERYT codes. The dataset is maintained by Statistics Poland (GUS) and is useful for analyzing local government education spending across the country over time.PUBLIC FINANCE › EXPENDITURE OF GMINAS AND CITIES WITH POWIAT STATUS BUDGETS. Local Data Bank (BDL) subject P2638: 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 education expenditure measure.GUS variable id selecting the measured series of subject P2638 (the n1/n2 dimension combination): 76646=gminas include cities with powiat status / total [PLN]; 101313=gminas include cities with powiat status / current expenditure, total [PLN]; 101310=gminas include cities with powiat status / current expenditure on wages and salaries [PLN]; 101307=gminas include cities with powiat status / current expenditure, wages and salaries related expenditures [PLN]; 101304=gminas include cities with powiat status / current expenditure on purchase of materials and services [PLN]; 76649=gminas include cities with powiat status / current expenditure of budgetary units, total [PLN]; 76709=gminas include cities with powiat status / current expenditure of budgetary entities on wages and salaries [PLN]; 76706=gminas include cities with powiat status / current expenditure of budgetary entities, resulting from wages and salaries [PLN]; 76703=gminas include cities with powiat status / current expenditure of budgetary entities on purchase of materials and services [PLN]; 76700=gminas include cities with powiat status / grants total [PLN]; 76697=gminas include cities with powiat status / benefits for natural persons [PLN]; 76652=gminas include cities with powiat status / property expenditure, total [PLN]; 76694=gminas include cities with powiat status / investment property expenditure [PLN]; 76655=gminas include cities with powiat status / expenditure in chapter 80101 - Primary schools [PLN]; 76685=gminas include cities with powiat status / expenditure in chapter 80102 - Special primary schools [PLN]; … (78 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P2638 for the full list). |
| unit_levelUnit level | integer | Territorial aggregation level of the record, from country to gmina.Territorial aggregation level: 0=Poland, 1=macroregion, 2=voivodship (województwo), 3=region, 4=subregion, 5=powiat, 6=gmina. |
| year | integer | Calendar year the expenditure value refers to.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 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 expenditure amount in PLN for the given variable.Reported expenditure amount in PLN for the given variable. |
| attr_idAttr id | integer | GUS data quality/annotation flag for 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 |
|---|---|---|---|---|---|---|---|
| 76646 | 6 | 1995 | 011212001011 | Bochnia | 1201011 | 5296138 | 1 |
| 76646 | 6 | 1996 | 011212001011 | Bochnia | 1201011 | 6904736 | 1 |
| 76646 | 6 | 1997 | 011212001011 | Bochnia | 1201011 | 8305151 | 1 |
| 76646 | 6 | 1998 | 011212001011 | Bochnia | 1201011 | 10482387 | 1 |
| 76646 | 6 | 1999 | 011212001011 | Bochnia | 1201011 | 12253078 | 1 |
| 76646 | 6 | 2000 | 011212001011 | Bochnia | 1201011 | 13673213 | 1 |
| 76646 | 6 | 2001 | 011212001011 | Bochnia | 1201011 | 13572644 | 11 |
| 76646 | 6 | 2002 | 011212001011 | Bochnia | 1201011 | 12184590 | 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/P2638
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/76646?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 76646 (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.