{"id":"6ee806c8-db34-46cc-805a-bd47b3f69ad5","type":"API","name":"Dwelling stocks","slug":"dwelling-stocks","description":"HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › DWELLING STOCK. Local Data Bank (BDL) subject P2166: 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":"VERIFIED","tags":[],"logo_url":"https://api.stat.gov.pl/Content/images/favicon.ico","primary_source_url":"https://bdl.stat.gov.pl/bdl/dane/podgrup/temat#P2166","extraction_confidence":"0.40","created_at":"2026-07-25T14:43:37.531Z","updated_at":"2026-09-08T21:05:30.909Z","last_verified_at":"2026-09-08T21:05:30.909Z","deprecated_at":null,"ranking_score":53,"last_ranked_at":"2026-08-31T04:17:35.068Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-09-08T02:31:05.443Z","search_vector":"'and':34B 'bank':12B,41B 'bdl':13B,42B 'by':56B 'data':11B,40B 'dwell':1A,8B 'dwelling':30A,37B 'economi':4B 'economy':33B 'for':48B 'gmina':23B,52B 'hous':3B 'housing':32B 'id':29B 'ids':58B 'infrastructur':7B 'infrastructure':36B 'key':26B 'keyed':55B 'level':24B,53B 'local':10B,39B 'municip':6B 'municipal':35B 'p2166':15B,44B 'poland':20B,49B 'seri':18B 'series':47B 'stock':2A,9B,38B 'stocks':31A 'subject':14B,43B 'territori':17B 'territorial':46B 'teryt':28B,57B 'to':51B 'unit':25B 'units':54B 'voivodship':21B,50B 'year':16B 'yearly':45B","popularity_score":"0.0000","maintenance_score":"0.7000","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-26T15:50:33.352Z","geographic_scope":"NATIONAL","name_en":null,"description_en":null,"native_lang":null,"access_level":"direct","formats":[],"capability_tier":"live","trust_score":48.25,"merged_into_entry_id":null,"identity_key":"API|https://bdl.stat.gov.pl/bdl/dane/podgrup/temat#P2166|dwelling stocks","upstream_ref":"bdl.stat.gov.pl:subject:P2166","access":{"level":"direct","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://bdl.stat.gov.pl/api/v1/subjects/P2166","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://bdl.stat.gov.pl/api/v1/subjects/P2166","source":"probe","runnable":true},{"kind":"query","label":"Values of one variable across territorial units","method":"GET","url":"https://bdl.stat.gov.pl/api/v1/data/by-variable/60811?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":"landing","label":"Open source record","method":"GET","url":"https://bdl.stat.gov.pl/bdl/dane/podgrup/temat#P2166","source":"primary_source","runnable":false}],"formats":[]},"maturity":{"entry_id":"6ee806c8-db34-46cc-805a-bd47b3f69ad5","granularity":"entry","granularity_label":"One unit = one catalog entry. A PROXY for the SCOPE.md §4 ladder, which governs source families, not entries: a family with 400 entries moves this reading 400 times as much as a family with one. Never compare or combine with the source_family reading.","level":"joinable","level_index":5,"level_label":"Joinable","meaning":"Canonical identifiers and concepts mapped","counts_as_coverage":true,"blocked_by":null,"rungs":[{"level":"discovered","level_index":1,"label":"Discovered","meaning":"Source and metadata recorded","evidence":"membership of the named population the ladder is taken over","counts_as_coverage":false,"met":true,"reached":true,"criterion":"TRUE"},{"level":"verified","level_index":2,"label":"Verified","meaning":"Access tested successfully","evidence":"entries.verification_state = 'VERIFIED'","counts_as_coverage":false,"met":true,"reached":true,"criterion":"entries.verification_state = 'VERIFIED'"},{"level":"profiled","level_index":3,"label":"Profiled","meaning":"Schema, dimensions and licence understood","evidence":"a data profile with at least one field (entry_data_profiles.field_count > 0)","counts_as_coverage":false,"met":true,"reached":true,"criterion":"EXISTS (SELECT 1 FROM entry_data_profiles p WHERE p.entry_id = entries.id AND COALESCE(p.field_count, 0) > 0)"},{"level":"executable","level_index":4,"label":"Executable","meaning":"Queries run through Commodity","evidence":"entries.capability_tier = 'live' — today's proxy for \"queryable through us\"","counts_as_coverage":true,"met":true,"reached":true,"criterion":"entries.capability_tier = 'live'"},{"level":"joinable","level_index":5,"label":"Joinable","meaning":"Canonical identifiers and concepts mapped","evidence":"a field link to a canonical identifier whose sampled VALUES match its format","counts_as_coverage":true,"met":true,"reached":true,"criterion":"EXISTS (SELECT 1 FROM entry_field_links efl WHERE efl.entry_id = entries.id AND efl.identifier_id IS NOT NULL AND efl.value_status = 'match')"},{"level":"reproducible","level_index":6,"label":"Reproducible","meaning":"Snapshots and transformation evidence retained","evidence":"at least one retained evidence manifest (migration 078)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM evidence_manifests em WHERE em.entry_id = entries.id)"},{"level":"guaranteed","level_index":7,"label":"Guaranteed","meaning":"Monitored against an operational reliability target","evidence":"an active reliability target with a named monitor (migration 096)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_reliability_targets rt WHERE rt.entry_id = entries.id AND rt.is_active = true)"}],"officialness":{"basis":"catalog_inherited","label":"Inherited from the upstream catalog: this item came from a trusted official government catalog, and that provenance — not per-item proof — is the warrant. Its own proof score is below 80 or it matched no registered institution (apps/worker/src/connectors/catalog/qualify-store.ts).","proof_confidence":40,"proven_threshold":80,"institution_id":"2b3815fc-d28d-444c-b8f1-906ef8cff848","definition":"CASE WHEN COALESCE(entries.is_public_sector, false) IS NOT TRUE THEN 'not_official' WHEN COALESCE(entries.official_confidence, 0) >= 80 AND entries.institution_id IS NOT NULL THEN 'per_item_proven' ELSE 'catalog_inherited' END"},"source_family":{"key":"bdl.stat.gov.pl","label":"One unit = one source family, approximated by the serving host of the entry's primary source URL (e.g. bdl.stat.gov.pl). A COMPUTED stand-in for the curated families of SCOPE.md §5, which no table holds yet. A family sits at the highest level any of its entries has reached, because a family is integrated to the depth of its deepest working integration. Never compare or combine with the entry reading."},"generated_at":"2026-09-08T21:51:33.869Z"},"api_details":{"id":"de911a9c-ecec-4e53-aece-d8f7aa7a5d78","entry_id":"6ee806c8-db34-46cc-805a-bd47b3f69ad5","base_url":"https://bdl.stat.gov.pl/api/v1/subjects/P2166","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/P2166","created_at":"2026-07-25T14:43:37.690Z","updated_at":"2026-07-25T14:43:37.690Z"},"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"},"reuse":{"license_id":"cc-by-4.0","license_name":"Creative Commons Attribution 4.0","license_url":"https://creativecommons.org/licenses/by/4.0/","commercial_use":{"status":"yes","value":true},"redistribution":{"status":"yes","value":true},"attribution_required":{"status":"yes","value":true},"share_alike":{"status":"no","value":false},"personal_data_warning":{"status":"yes","value":true},"cache_and_mirror":{"status":"yes","value":true},"undetermined":[],"basis":"licence_text","confidence":0.95,"confidence_tier":"high","source_text":"Deed: \"Share - copy and redistribute the material in any medium or format for any purpose, even commercially\" and \"Adapt - remix, transform, and build upon the material for any purpose, even commercially\". Under the following terms: \"Attribution - You must give appropriate credit, provide a link to the license, and indicate if changes were made.\" Notices: \"other rights such as publicity, privacy, or moral rights may limit how you use the material.\" Attribution is the only term listed; no ShareAlike term appears.","source_url":"https://creativecommons.org/licenses/by/4.0/","reviewed_at":null},"license_raw":"CC BY 4.0 (GUS BDL)","latest_check":{"id":"a5b63afc-40af-4059-bd62-d41bf14d0587","entry_id":"6ee806c8-db34-46cc-805a-bd47b3f69ad5","status":"VERIFIED","last_checked_at":"2026-09-08T21:05:30.626Z","p50_latency_ms":1340,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-07-25T21:43:52.468Z","updated_at":"2026-09-08T21:05:30.626Z","consecutive_successes":5,"probe_url":"https://bdl.stat.gov.pl/api/v1/subjects/P2166","probe_method":"GET","probe_http_status":200,"probe_content_type":"application/json; charset=utf-8","probe_succeeded_at":"2026-09-08T21:05:30.626Z"},"data_profile":{"id":"aba4f88c-a47a-495c-a12e-7ede4b4011b5","entry_id":"6ee806c8-db34-46cc-805a-bd47b3f69ad5","profile_source":"bdl","profile_kind":"dataset","dataset_id":"P2166","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 P2166 (the n1/n2 dimension combination): 60811=total / dwellings [-]; 60808=total / rooms [-]; 60813=total / useful floor area of dwellings [m2]; 60807=in urban areas / dwellings [-]; 60809=in urban areas / rooms [-]; 60810=in urban areas / useful floor area of dwellings [m2]; 60812=in rural areas / dwellings [-]; 60814=in rural areas / rooms [-]; 60806=in rural areas / useful floor area of dwellings [m2].","enum_values":["60811","60808","60813","60807","60809","60810","60812","60814","60806"],"description_en":"GUS code selecting the measured dwelling stock variable and area type."},{"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"],"description_en":"Territorial aggregation level, from national to gmina level."},{"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.","description_en":"Reference year of the yearly data value."},{"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).","description_en":"12-digit BDL identifier of the territorial unit."},{"name":"unit_name","type":"string","label":null,"description":null,"description_en":"Name of the territorial unit, such as a town or gmina."},{"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).","description_en":"TERYT TERC administrative code of the territorial unit."},{"name":"value","type":"number","label":null,"description":null,"description_en":"Measured value of dwellings, rooms, or floor area."},{"name":"attr_id","type":"integer","label":null,"description":"GUS value-attribute id (data quality/annotation flag).","description_en":"GUS attribute code flagging data quality or annotation."}],"field_count":8,"sample_records":[{"year":1995,"value":8563,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"60811"},{"year":1996,"value":8592,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"60811"},{"year":1997,"value":8654,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"60811"},{"year":1998,"value":8685,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"60811"},{"year":1999,"value":8737,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"60811"},{"year":2000,"value":8797,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"60811"},{"year":2001,"value":8875,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"60811"},{"year":2002,"value":9087,"attr_id":11,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"60811"}],"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://bdl.stat.gov.pl/api/v1/data/by-variable/60811?unit-level=6&page-size=10&format=json&lang=en","curl":"curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/60811?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 60811 (total / 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-09-04T11:52:49.896Z","run_id":"5b99b2cd-2e49-4e44-b382-e618cd78e0f2","created_at":"2026-07-25T14:46:57.859Z","updated_at":"2026-09-04T11:52:49.896Z","license_raw":"CC BY 4.0 (GUS BDL)","license_id":"cc-by-4.0","consecutive_failure_count":0,"last_error_at":null,"last_error_message":null,"previewable":true,"personal_data":{"status":"none","basis":"no_person_column_cited","grain":"none","allowed":true,"columns":{"direct_identifiers":[],"family_names":[],"given_names":[],"attributes":[],"unresolved_names":[],"measures":[],"entity_identifiers":[]},"publication":null,"publication_evidence":null,"notice":"personal data: no cited column names a natural person (the cited columns are all this reads)"}},"datasets":[],"limits":[],"manifest":{"answer_sha256":"53f16b06ab989486d1aecf134d4a966c6b2cf467517e877ee34217700bc2b3b4","answer_sha256_rule":"sha256 (hex, UTF-8) of JSON.stringify(this body) after deleting the keys listed in manifest.stamped_keys from manifest, and deleting manifest itself if it is then empty. The hash was computed before the stamp existed, so no field of the stamp is inside it.","stamped_keys":["answer_sha256","answer_sha256_rule","stamped_keys","row_count","row_count_basis","live","live_basis","created_at","created_at_basis","durable_citation"],"row_count":29,"row_count_basis":"Objects that are elements of a JSON array anywhere in this body, excluding manifest. Not a claim about which collection is the answer. Largest single collection: data_profile.fields[] (8 rows).","live":false,"live_basis":"This body was replayed from the worker edge cache (x-edge-cache: hit); the bytes, and therefore answer_sha256, are those of the execution that filled the cache.","created_at":"2026-09-08T21:51:56.316Z","created_at_basis":"When this response body was assembled, deliberately OUTSIDE the hashed bytes so the same answer hashes identically on every request. Not the upstream read time — that is provenance[].retrieved_at. A zone-cached replay carries the assembly time, not your receipt time.","durable_citation":"This manifest is produced at response time and is NOT stored. A durable, replayable citation is persisted only on an explicit cite: GET /api/v1/entries/{id-or-slug}/evidence, or the MCP cite_query tool. Both are entry-scoped, because evidence_manifests is entry-shaped; a domain answer spanning several sources has no single entry and cannot be persisted through that path."}}