Rooms by type of dwelling ownership
This API provides access to a statistical series from Statistics Poland's (GUS) Local Data Bank (BDL), specifically subject P2354, covering housing economy and municipal infrastructure data related to dwelling stock. It offers yearly territorial time series for Poland, broken down by administrative units from voivodship to gmina level, each identified by TERYT codes. The data is published and maintained by GUS Poland and is freely accessible without authentication. It is intended for statistical and administrative use in analyzing housing-related indicators across different levels of Polish territorial division.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › DECREMENT IN DWELLING STOCK. Local Data Bank (BDL) subject P2354: 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 identifying ownership type and room measure.GUS variable id selecting the measured series of subject P2354 (the n1/n2 dimension combination): 59542=total / rooms, total [-]; 59544=total / average number of rooms in a dwelling [-]; 59546=natural person / rooms, total [-]; 59549=natural person / average number of rooms in a dwelling [-]; 59547=housing cooperative / rooms, total [-]; 59548=housing cooperative / average number of rooms in a dwelling [-]; 59555=owned by gmina / rooms, total [-]; 59550=owned by gmina / average number of rooms in a dwelling [-]; 59552=workplaces / rooms, total [-]; 59545=workplaces / average number of rooms in a dwelling [-]; 59554=public building society (TBS) / rooms, total [-]; 59543=public building society (TBS) / average number of rooms in a dwelling [-]; 59551=other entities / rooms, total [-]; 59553=other entities / average number of rooms in a dwelling [-]. |
| unit_levelUnit level | integer | Territorial aggregation level, from Poland down to gmina.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 data 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 territorial code for the 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 | Numeric value of the measured room indicator.Numeric value of the measured room indicator. |
| attr_idAttr id | integer | GUS data quality or annotation flag code.GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 4 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 |
|---|---|---|---|---|---|---|---|
| 59542 | — | 2003 | 000000000000 | POLAND | — | 13233 | 1 |
| 59542 | — | 2004 | 000000000000 | POLAND | — | 12629 | 1 |
| 59542 | — | 2005 | 000000000000 | POLAND | — | 13791 | 1 |
| 59542 | — | 2006 | 000000000000 | POLAND | — | 13172 | 1 |
| 59542 | — | 2007 | 000000000000 | POLAND | — | 9408 | 1 |
| 59542 | — | 2003 | 010000000000 | MACROREGION POŁUDNIOWY | — | 3801 | 1 |
| 59542 | — | 2004 | 010000000000 | MACROREGION POŁUDNIOWY | — | 3123 | 1 |
| 59542 | — | 2005 | 010000000000 | MACROREGION POŁUDNIOWY | — | 4851 | 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/P2354
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/59542?page-size=10&format=json&lang=en'Yearly values of variable 59542 (total / rooms, total [-]) 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.