Price indices of consumer goods and services, COICOP 1999 classification, data up to 2025

APIDiscovered1/7blocked by verifiedQuery nowOpen workbench Subscribe🇵🇱Poland

API providing access to subject P2955 of the Local Data Bank (BDL), maintained by GUS (Statistics Poland). It contains yearly territorial series on price indices of consumer goods and services under the COICOP 1999 classification, covering data up to 2025. Series are broken down by territorial units from voivodship down to gmina level, identified via TERYT codes. The dataset falls under the Prices theme, specifically Price Indices, and is intended for statistical and analytical use concerning consumer price developments across Polish administrative divisions.”PRICES › PRICE INDICES. Local Data Bank (BDL) subject P2955: 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 code identifying the price index category measured.GUS variable id selecting the measured series of subject P2955 (the n1/n2 dimension combination): 217230=total [-]; 217231=food and non-alcoholic beverages [-]; 217232=alcoholic beverages, tobacco [-]; 217233=clothing and footwear [-]; 217234=dwelling [-]; 217235=health [-]; 217236=transport [-]; 217237=recreation and culture [-]; 217238=education [-].
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 for the yearly price index 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 code.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. Poland or a region.Name of the territorial unit, e.g. Poland or a region.
teryt_tercTeryt terc	string	TERYT TERC administrative 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	Price index value for the given category, unit and year.Price index value for the given category, unit and year.
attr_idAttr id	integer	GUS data-quality attribute flag for the value.GUS value-attribute id (data quality/annotation flag).

Schema captured from bdl 7 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
217230	—	2003	POLAND	—	100.8	1
217230	—	2004	POLAND	—	103.5	1
217230	—	2005	POLAND	—	102.1	1
217230	—	2006	POLAND	—	101	1
217230	—	2007	POLAND	—	102.5	1
217230	—	2008	POLAND	—	104.2	1
217230	—	2009	POLAND	—	103.5	1
217230	—	2010	POLAND	—	102.6	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/P2955

License

Creative Commons Attribution 4.0Open

✓ Redistributable
✓ Attribution required

Query examples

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

Yearly values of variable 217230 (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.

Full API documentation ↗

Machine-readable & source

JSON

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.