{"id":"e9d3a6da-c1e5-4ec0-98b6-c02ae5b302ff","type":"API","name":"Rental of premises from dwelling stock of gmina and temporary premises","slug":"rental-of-premises-from-dwelling-stock-of-gmina-and-temporary-premises","description":"HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › DWELLING STOCK. Local Data Bank (BDL) subject P3950: 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#P3950","extraction_confidence":"0.40","created_at":"2026-07-25T14:43:31.397Z","updated_at":"2026-07-25T16:11:31.527Z","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':47A,52B 'bank':21B,59B 'bdl':22B,60B 'by':74B 'data':20B,58B 'dwell':5A,17B 'dwelling':43A,55B 'economi':13B 'economy':51B 'for':66B 'from':42A 'gmina':8A,32B,46A,70B 'hous':12B 'housing':50B 'id':38B 'ids':76B 'infrastructur':16B 'infrastructure':54B 'key':35B 'keyed':73B 'level':33B,71B 'local':19B,57B 'municip':15B 'municipal':53B 'of':40A,45A 'p3950':24B,62B 'poland':29B,67B 'premis':3A,11A 'premises':41A,49A 'rental':1A,39A 'seri':27B 'series':65B 'stock':6A,18B,44A,56B 'subject':23B,61B 'temporari':10A 'temporary':48A 'territori':26B 'territorial':64B 'teryt':37B,75B 'to':69B 'unit':34B 'units':72B 'voivodship':30B,68B 'year':25B 'yearly':63B","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-26T16:32:40.009Z","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/1612714?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/1612714?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/P3950","source":"base_url","runnable":false},{"kind":"landing","label":"Open source record","method":"GET","url":"https://bdl.stat.gov.pl/bdl/dane/podgrup/temat#P3950","source":"primary_source","runnable":false}],"formats":[]},"api_details":{"id":"d194a61e-9b41-4bcb-9aec-de75576886aa","entry_id":"e9d3a6da-c1e5-4ec0-98b6-c02ae5b302ff","base_url":"https://bdl.stat.gov.pl/api/v1/subjects/P3950","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/P3950","created_at":"2026-07-25T14:43:31.559Z","updated_at":"2026-07-25T14:43:31.559Z"},"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":"6066ff82-247a-47c8-9e22-64d5efe1d193","entry_id":"e9d3a6da-c1e5-4ec0-98b6-c02ae5b302ff","profile_source":"bdl","profile_kind":"dataset","dataset_id":"P3950","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 P3950 (the n1/n2 dimension combination): 1612714=rental contracts of premises  - existing / premises [-]; 1612715=rental contracts of premises  - existing / useful floor area of premises [m2]; 1612716=rental contracts of premises  - existing / social rental contracts [-]; 1612717=rental contracts of premises  - existing / useful floor area of premises with social rental contracts [m2]; 1612718=rental contracts of premises - concluded / premises [-]; 1612719=rental contracts of premises - concluded / useful floor area of premises [m2]; 1612720=rental contracts of premises - concluded / social rental contracts [-]; 1612721=rental contracts of premises - concluded / useful floor area of premises with social rental contracts [m2]; 1612722=rental contracts of premises - terminated / premises [-]; 1612723=rental contracts of premises - terminated / useful floor area of premises [m2]; 1612724=rental contracts of premises - terminated / social rental contracts [-]; 1612725=rental contracts of premises - terminated / useful floor area of premises with social rental contracts [m2]; 1621955=rental contracts of premises  - existing / premises [-]; 1621956=rental contracts of premises  - existing / useful floor area of premises [m2]; 1621957=rental contracts of premises - concluded / premises [-]; … (18 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P3950 for the full list).","enum_values":["1612714","1612715","1612716","1612717","1612718","1612719","1612720","1612721","1612722","1612723","1612724","1612725","1621955","1621956","1621957","1621958","1621959","1621960"]},{"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":2019,"value":275,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011"},{"year":2020,"value":257,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011"},{"year":2021,"value":277,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011"},{"year":2022,"value":254,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011"},{"year":2023,"value":237,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011"},{"year":2024,"value":227,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011"},{"year":2019,"value":6,"attr_id":1,"unit_id":"011212001022","unit_name":"Bochnia","teryt_terc":"1201022"},{"year":2020,"value":6,"attr_id":1,"unit_id":"011212001022","unit_name":"Bochnia","teryt_terc":"1201022"}],"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://bdl.stat.gov.pl/api/v1/data/by-variable/1612714?unit-level=6&page-size=10&format=json&lang=en","curl":"curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/1612714?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 1612714 (rental contracts of premises  - existing / premises [-]) 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:44.275Z","run_id":"9165c2a1-a1bd-4871-afc7-1042c4f3dec5","created_at":"2026-07-25T14:46:44.275Z","updated_at":"2026-07-25T14:46:44.275Z","license_raw":"CC BY 4.0 (GUS BDL)","license_id":"cc-by-4.0","previewable":true},"datasets":[],"limits":[]}