Population in dwellings
HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › ARCHIVAL DATA. Local Data Bank (BDL) subject P1717: 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 measured series (377 = total population, persons).GUS variable id selecting the measured series of subject P1717 (the n1/n2 dimension combination): 377=total [person]. |
| unit_levelUnit level | integer | Territorial aggregation level, from country (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 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 for the reporting area.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. town or gmina.Name of the territorial unit, e.g. town or gmina. |
| teryt_tercTeryt terc | string | TERYT TERC administrative code derived from the unit id.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 | Number of persons living in dwellings for the given unit and year.Number of persons living in dwellings for the given unit and year. |
| 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 5 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 |
|---|---|---|---|---|---|---|---|
| 377 | 6 | 1995 | 011212001011 | Bochnia | 1201011 | 28417 | 1 |
| 377 | 6 | 1996 | 011212001011 | Bochnia | 1201011 | 28603 | 1 |
| 377 | 6 | 1997 | 011212001011 | Bochnia | 1201011 | 28648 | 1 |
| 377 | 6 | 1998 | 011212001011 | Bochnia | 1201011 | 28721 | 1 |
| 377 | 6 | 1999 | 011212001011 | Bochnia | 1201011 | 28842 | 1 |
| 377 | 6 | 2000 | 011212001011 | Bochnia | 1201011 | 28839 | 1 |
| 377 | 6 | 2001 | 011212001011 | Bochnia | 1201011 | 28868 | 1 |
| 377 | 6 | 1995 | 011212001022 | Bochnia | 1201022 | 16304 | 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/P1717
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/377?unit-level=6&page-size=10&format=json&lang=en'Yearly values of variable 377 (total [person]) 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.