{"id":"87bdd7c6-d670-4cc7-adc0-151460b782b3","type":"API","name":"Unoccupied apartments in the municipal resource (vacant)","slug":"unoccupied-apartments-in-the-municipal-resource-vacant","description":"HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › DWELLING STOCK. Local Data Bank (BDL) subject P2908: yearly territorial series for Poland (voivodship to gmina level), units keyed by TERYT ids.","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"https://api.stat.gov.pl/Home/BdlApi","docs_url":"https://api.stat.gov.pl/Home/BdlApi","repo_url":null,"status":"ACTIVE","verification_state":"UNVERIFIED","tags":[],"logo_url":"https://api.stat.gov.pl/Content/images/favicon.ico","primary_source_url":"https://bdl.stat.gov.pl/bdl/dane/podgrup/temat#P2908","extraction_confidence":"0.40","created_at":"2026-07-25T14:43:12.851Z","updated_at":"2026-07-25T16:11:27.008Z","last_verified_at":null,"deprecated_at":null,"ranking_score":0,"last_ranked_at":null,"last_seen_at":null,"last_validated_at":null,"last_uptime_at":null,"search_vector":"'and':44B 'apart':2A 'apartments':36A 'bank':17B,51B 'bdl':18B,52B 'by':66B 'data':16B,50B 'dwell':13B 'dwelling':47B 'economi':9B 'economy':43B 'for':58B 'gmina':28B,62B 'hous':8B 'housing':42B 'id':34B 'ids':68B 'in':37A 'infrastructur':12B 'infrastructure':46B 'key':31B 'keyed':65B 'level':29B,63B 'local':15B,49B 'municip':5A,11B 'municipal':39A,45B 'p2908':20B,54B 'poland':25B,59B 'resourc':6A 'resource':40A 'seri':23B 'series':57B 'stock':14B,48B 'subject':19B,53B 'territori':22B 'territorial':56B 'teryt':33B,67B 'the':38A 'to':61B 'unit':30B 'units':64B 'unoccupi':1A 'unoccupied':35A 'vacant':7A,41A 'voivodship':26B,60B 'year':21B 'yearly':55B","popularity_score":"0.0000","maintenance_score":"0.0000","institution_id":"2b3815fc-d28d-444c-b8f1-906ef8cff848","institution_type":"STATISTICS_OFFICE","country_code":"PL","official_confidence":40,"proof_summary":"40% - Official domain (stat.gov.pl)","source_seed_url":null,"is_public_sector":true,"published_at":"2026-07-25T20:52:56.957Z","geographic_scope":"NATIONAL","name_en":null,"description_en":null,"native_lang":null,"access_level":"documented","formats":[],"capability_tier":"live","trust_score":33.25,"access":{"level":"documented","primary":{"kind":"query","label":"Values of one variable across territorial units","method":"GET","url":"https://bdl.stat.gov.pl/api/v1/data/by-variable/1646172?unit-level=6&page-size=10&format=json&lang=en","source":"query_example","runnable":true,"direct":false},"actions":[{"kind":"query","label":"Values of one variable across territorial units","method":"GET","url":"https://bdl.stat.gov.pl/api/v1/data/by-variable/1646172?unit-level=6&page-size=10&format=json&lang=en","source":"query_example","runnable":true,"direct":false},{"kind":"query","label":"Documentation","method":"GET","url":"https://api.stat.gov.pl/Home/BdlApi","source":"query_example","runnable":true,"direct":false},{"kind":"query","label":"API base URL","method":"GET","url":"https://bdl.stat.gov.pl/api/v1/subjects/P2908","source":"base_url","runnable":false},{"kind":"landing","label":"Open source record","method":"GET","url":"https://bdl.stat.gov.pl/bdl/dane/podgrup/temat#P2908","source":"primary_source","runnable":false}],"formats":[]},"api_details":{"id":"c0077ecf-9a93-4aa0-866c-24334151f6c2","entry_id":"87bdd7c6-d670-4cc7-adc0-151460b782b3","base_url":"https://bdl.stat.gov.pl/api/v1/subjects/P2908","openapi_url":null,"graphql_url":null,"api_version":null,"spec_format":null,"endpoints_count":null,"endpoints":[],"rate_limit_info":null,"free_tier_limits":null,"ping_url":"https://bdl.stat.gov.pl/api/v1/subjects/P2908","created_at":"2026-07-25T14:43:13.010Z","updated_at":"2026-07-25T14:43:13.010Z"},"dataset_details":null,"license":{"id":"cc-by-4.0","spdx_id":"CC-BY-4.0","name":"Creative Commons Attribution 4.0","url":"https://creativecommons.org/licenses/by/4.0/","is_open":true,"is_redistributable":true,"requires_attribution":true,"category":"cc","notes":null,"created_at":"2026-06-12T16:29:19.729Z"},"license_raw":"CC BY 4.0 (GUS BDL)","latest_check":null,"data_profile":{"id":"1630562c-4914-4782-b62f-15c1f96d5bf5","entry_id":"87bdd7c6-d670-4cc7-adc0-151460b782b3","profile_source":"bdl","profile_kind":"dataset","dataset_id":"P2908","fields":[{"name":"variable_id","role":"parameter","type":"string","label":null,"param_in":"path","required":true,"description":"GUS variable id selecting the measured series of subject P2908 (the n1/n2 dimension combination): 1646172=total uninhabited dwelling / dwellings [-]; 1646173=total uninhabited dwelling / useful floor area of dwellings [m2]; 1646174=due to waiting for settlement / dwellings [-]; 1646175=due to waiting for settlement / useful floor area of dwellings [m2]; 1646176=due to the purpose of renovation / dwellings [-]; 1646177=due to the purpose of renovation / useful floor area of dwellings [m2]; 1646178=due to the intended for demolition / dwellings [-]; 1646179=due to the intended for demolition / useful floor area of dwellings [m2]; 1646180=due to poor technical condition / dwellings [-]; 1646181=due to poor technical condition / useful floor area of dwellings [m2]; 1646182=due to other reasons / dwellings [-]; 1646183=due to other reasons / useful floor area of dwellings [m2].","enum_values":["1646172","1646173","1646174","1646175","1646176","1646177","1646178","1646179","1646180","1646181","1646182","1646183"]},{"name":"unit_level","role":"parameter","type":"integer","label":null,"param_in":"query","description":"Territorial aggregation level: 0=Poland, 1=macroregion, 2=voivodship (województwo), 3=region, 4=subregion, 5=powiat, 6=gmina.","enum_values":["0","1","2","3","4","5","6"]},{"name":"year","role":"parameter","type":"integer","label":null,"param_in":"query","description":"Reference year of the value (yearly series, back to 1995 for the oldest subjects). Filters server-side via the API's year parameter."},{"name":"unit_id","type":"string","label":null,"description":"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)."},{"name":"unit_name","type":"string","label":null,"description":null},{"name":"teryt_terc","type":"string","label":null,"description":"TERYT TERC territorial code derived from the unit id (2 digits = voivodship, 4 = powiat, 7 = gmina incl. type digit; empty for NUTS-only units)."},{"name":"value","type":"number","label":null,"description":null},{"name":"attr_id","type":"integer","label":null,"description":"GUS value-attribute id (data quality/annotation flag)."}],"field_count":8,"sample_records":[{"year":2003,"value":3,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011"},{"year":2005,"value":4,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011"},{"year":2007,"value":11,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011"},{"year":2009,"value":9,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011"},{"year":2013,"value":17,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011"},{"year":2015,"value":12,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011"},{"year":2016,"value":16,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011"},{"year":2018,"value":34,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011"}],"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://bdl.stat.gov.pl/api/v1/data/by-variable/1646172?unit-level=6&page-size=10&format=json&lang=en","curl":"curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/1646172?unit-level=6&page-size=10&format=json&lang=en'","label":"Values of one variable across territorial units","method":"GET","description":"Yearly values of variable 1646172 (total uninhabited dwelling / dwellings [-]) 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."},{"url":"https://api.stat.gov.pl/Home/BdlApi","curl":"curl -s 'https://api.stat.gov.pl/Home/BdlApi'","label":"Documentation","method":"GET","description":"GUS BDL API reference (endpoints, parameters, limits, CC BY 4.0 licence)."}],"status":"ok","error_message":null,"profiled_at":"2026-07-25T14:46:25.721Z","run_id":"e1a8be45-4908-424c-bf78-ffce8ff7d962","created_at":"2026-07-25T14:46:25.721Z","updated_at":"2026-07-25T14:46:25.721Z","license_raw":"CC BY 4.0 (GUS BDL)","license_id":"cc-by-4.0","previewable":true},"datasets":[],"limits":[]}