Number and amount of dwelling allowances paid to the users
This API provides access to Local Data Bank (BDL) subject P2173, part of the housing economy and municipal infrastructure category covering housing allowances. It contains yearly territorial time series for Poland, reporting the number and amount of dwelling allowances paid to users, disaggregated from voivodship down to gmina level. Statistical units are keyed using official TERYT territorial identifiers. The dataset is maintained by GUS, the Polish national statistical office, and can be used for regional analysis of housing support programs and municipal infrastructure spending over time.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › HOUSING ALLOWANCES. Local Data Bank (BDL) subject P2173: 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 selecting the measured series of subject P2173 (the n1/n2 dimension combination): 54861=total / number [pcs]; 54857=total / amount [PLN]; 1612138=total / average amount of allowances [PLN]; 54869=of gminas housing dwellings / number [pcs]; 54864=of gminas housing dwellings / amount [PLN]; 1612161=of gminas housing dwellings / average amount of allowances [PLN]; 1612142=of gminas housing dwellings / % of total number of dwelling allowances paid out [%]; 1612143=of gminas housing dwellings / % of total amount of dwelling allowances paid out [%]; 54866=of housing cooperatives dwellings / number [pcs]; 54867=of housing cooperatives dwellings / amount [PLN]; 1612144=of housing cooperatives dwellings / average amount of allowances [PLN]; 1612145=of housing cooperatives dwellings / % of total number of dwelling allowances paid out [%]; 1612146=of housing cooperatives dwellings / % of total amount of dwelling allowances paid out [%]; 54858=of private premises in buidings covered by housing condominiums / number [pcs]; 54860=of private premises in buidings covered by housing condominiums / amount [PLN]; … (33 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P2173 for the full list). |
| unit_levelUnit level | integer | 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 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 id (macroregion+voivodship+region+subregion+powiat+gmina+type digits). An equality filter pins the unit server-side (unit-parent-id). |
| unit_nameUnit name | string | — |
| teryt_tercTeryt terc | string | 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 | — |
| attr_idAttr id | integer | 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 |
|---|---|---|---|---|---|---|---|
| 54861 | 6 | 2004 | 011212001011 | Bochnia | 1201011 | 6110 | 1 |
| 54861 | 6 | 2005 | 011212001011 | Bochnia | 1201011 | 5339 | 1 |
| 54861 | 6 | 2006 | 011212001011 | Bochnia | 1201011 | 4650 | 1 |
| 54861 | 6 | 2007 | 011212001011 | Bochnia | 1201011 | 4296 | 1 |
| 54861 | 6 | 2008 | 011212001011 | Bochnia | 1201011 | 3480 | 1 |
| 54861 | 6 | 2009 | 011212001011 | Bochnia | 1201011 | 2961 | 1 |
| 54861 | 6 | 2010 | 011212001011 | Bochnia | 1201011 | 3078 | 1 |
| 54861 | 6 | 2011 | 011212001011 | Bochnia | 1201011 | 3126 | 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/P2173
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/54861?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 54861 (total / number [pcs]) 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.