Employees in vocational activity establishments

APIExecutable4/7Query nowOpen workbench Subscribe🇵🇱Poland

SOCIAL ECONOMY › REINTEGRATION UNITS. Local Data Bank (BDL) subject P4057: 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 selecting the measured series (employee counts or shares by disability status).GUS variable id selecting the measured series of subject P4057 (the n1/n2 dimension combination): 1621786=employees grand total / in absolute numbers [person]; 1621787=employees grand total / percent (Poland=100) [%]; 1621788=employees with a disability certificate / in absolute numbers [person]; 1621789=employees with a disability certificate / percent (Poland=100) [%]; 1621790=employed persons with a severe disability certificate / in absolute numbers [person]; 1621791=employed persons with a severe disability certificate / percent (Poland=100) [%]; 1621792=employees with a certificate of moderate disability / in absolute numbers [person]; 1621793=employees with a certificate of moderate disability / percent (Poland=100) [%].
unit_levelUnit level	integer	Territorial aggregation level from country 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 administrative 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 for the selected variable, unit, and year.Measured value for the selected variable, unit, and year.
attr_idAttr id	integer	GUS data quality/annotation flag for the value.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_name	teryt_terc	value	attr_id
1621786	—	2017	POLAND	—	6015	1
1621786	—	2018	POLAND	—	6666	1
1621786	—	2019	POLAND	—	7231	1
1621786	—	2020	POLAND	—	7429	1
1621786	—	2021	POLAND	—	8204	1
1621786	—	2022	POLAND	—	8645	1
1621786	—	2023	POLAND	—	9174	1
1621786	—	2024	POLAND	—	9779	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/P4057

License

Creative Commons Attribution 4.0Open

✓ Redistributable
✓ Attribution required

Query examples

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

Yearly values of variable 1621786 (employees grand total / in absolute numbers [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.

Full API documentation ↗