Allocations of dwellings in municipal dwelling stock - Allocated dwellings

APIJoinable5/7Query nowOpen workbench Subscribe🇵🇱Poland

Part of Poland's Local Data Bank (BDL), maintained by the national statistical office GUS, providing yearly territorial statistics on dwellings allocated from municipal housing stock. The dataset falls under the Housing Economy and Municipal Infrastructure subject group, specifically archival data category, subject code P1739. Figures are available across administrative levels from voivodship down to gmina, with territorial units identified by TERYT codes. Accessible via the BDL API without authentication, this data supports analysis of municipal housing allocation trends across Poland's regions and localities over time.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › ARCHIVAL DATA. Local Data Bank (BDL) subject P1739: yearly territorial series for Poland (voivodship to gmina level), units keyed by TERYT ids.

Values of one variable across territorial units Documentation Open source record

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 within subject P1739.GUS variable id selecting the measured series of subject P1739 (the n1/n2 dimension combination): 436=dwellings made available for new allocation [-]; 437=dwellings allocated, total [-]; 438=dwellings allocated for non-residential purposes [-].
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 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 code for the territorial unit, if applicable.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 dwellings reported for the selected variable and unit.Number of dwellings reported for the selected variable and unit.
attr_idAttr id	integer	GUS attribute id 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.

Where=

Sort by

Sample data (8 records)

variable_id	unit_level	year	unit_id	unit_name	teryt_terc	value	attr_id
436	6	1995	011212001011	Bochnia	1201011	47	1
436	6	1996	011212001011	Bochnia	1201011	1	1
436	6	1995	011212001022	Bochnia	1201022	1	1
436	6	1996	011212001022	Bochnia	1201022	0	0
436	6	1995	011212001032	Drwinia	1201032	0	0
436	6	1996	011212001032	Drwinia	1201032	0	0
436	6	1995	011212001042	Lipnica Murowana	1201042	0	0
436	6	1996	011212001042	Lipnica Murowana	1201042	0	0

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/P1739

License

Creative Commons Attribution 4.0Open

✓ Redistributable
✓ Attribution required

Query examples

curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/436?unit-level=6&page-size=10&format=json&lang=en'

Yearly values of variable 436 (dwellings made available for new allocation [-]) 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.

Full API documentation ↗