Land transferred/sold to investors for housing construction

APIJoinable5/7Query nowOpen workbench Subscribe🇵🇱Poland

This API provides access to subject P3954 of Poland's Local Data Bank (Bank Danych Lokalnych, BDL), covering land transferred or sold to investors for housing construction under the housing economy and municipal infrastructure category. It offers yearly territorial time series from voivodship down to gmina level, with administrative units identified by TERYT codes. The dataset is maintained by GUS, the Polish national statistical office, and can be used for analyzing land management trends related to housing development across Polish territorial units.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › MANAGEMENT OF LAND FOR HOUSING CONSTRUCTION. Local Data Bank (BDL) subject P3954: 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 specific measured series of subject P3954.GUS variable id selecting the measured series of subject P3954 (the n1/n2 dimension combination): 1612792=total [ha]; 1612793=multi-family [ha]; 1612794=single-family [ha]; 1612795=housing cooperatives [ha]; 1612796=gminas [ha]; 1612797=public building societies [ha]; 1612798=natural persons [ha]; 1612799=companies and other [ha].
unit_levelUnit level	integer	Territorial aggregation level, from 0 (Poland) to 6 (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 recorded 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 identifier of the territorial unit.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 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	Measured value of land area for the given series, in hectares.Measured value of land area for the given series, in hectares.
attr_idAttr id	integer	GUS attribute code indicating data quality or annotation.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.

Where=

Sort by

Sample data (8 records)

variable_id	unit_level	year	unit_id	unit_name	teryt_terc	value	attr_id
1612792	6	2020	011212001011	Bochnia	1201011	0	0
1612792	6	2021	011212001011	Bochnia	1201011	0	0
1612792	6	2022	011212001011	Bochnia	1201011	0	0
1612792	6	2023	011212001011	Bochnia	1201011	0.4	1
1612792	6	2024	011212001011	Bochnia	1201011	0	0
1612792	6	2025	011212001011	Bochnia	1201011	0.2	1
1612792	6	2020	011212001022	Bochnia	1201022	0	0
1612792	6	2021	011212001022	Bochnia	1201022	1	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/P3954

License

Creative Commons Attribution 4.0Open

✓ Redistributable
✓ Attribution required

Query examples

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

Yearly values of variable 1612792 (total [ha]) 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 ↗