{"id":"171c0921-db53-4e2b-9fbb-c97d0ae24c44","type":"DATASET","name":"European Central Bank — Structural Housing Indicators Statistics (SHI)","slug":"ecb-structural-housing-indicators-statistics-shi","description":"Structural Housing Indicators Statistics (SHI) — official time series from the European Central Bank Data Portal, published as the SHI dataflow over SDMX 2.1 REST. One endpoint serves XML (SDMX-ML), CSV (?format=csvdata) and JSON (?format=jsondata); extract exactly the series you need with a key path and startPeriod / endPeriod / lastNObservations filters. Browse and chart the same series on the ECB Data Portal.","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"https://data.ecb.europa.eu/data/datasets/SHI","docs_url":"https://data.ecb.europa.eu/help/api/overview","repo_url":null,"status":"ACTIVE","verification_state":"VERIFIED","tags":["economy","prices"],"logo_url":"https://data.ecb.europa.eu/themes/custom/edp/favicon.ico","primary_source_url":"https://data-api.ecb.europa.eu/service/data/SHI/all?lastNObservations=1&format=jsondata","extraction_confidence":"0.95","created_at":"2026-07-18T21:24:13.966Z","updated_at":"2026-09-01T21:58:04.107Z","last_verified_at":"2026-09-01T21:58:04.107Z","deprecated_at":null,"ranking_score":61,"last_ranked_at":"2026-08-22T13:47:45.635Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":null,"search_vector":"'2.1':31B,105B 'a':128B 'and':117B,131B,137B 'as':99B 'bank':3A,21B,77A,95B 'brows':62B 'browse':136B 'central':2A,20B,76A,94B 'chart':64B,138B 'csv':40B,114B 'csvdata':42B,116B 'data':22B,71B,96B,145B 'dataflow':28B,102B 'ecb':70B,144B 'economi':73C 'endperiod':59B,133B 'endpoint':34B,108B 'european':1A,19B,75A,93B 'exact':48B 'exactly':122B 'extract':47B,121B 'filter':61B 'filters':135B 'format':41B,45B,115B,119B 'from':91B 'hous':5A,10B 'housing':79A,84B 'indic':6A,11B 'indicators':80A,85B 'json':44B,118B 'jsondata':46B,120B 'key':55B,129B 'lastnobserv':60B 'lastnobservations':134B 'ml':39B,113B 'need':52B,126B 'offici':14B 'official':88B 'on':142B 'one':33B,107B 'over':103B 'path':56B,130B 'portal':23B,72B,97B,146B 'price':74C 'publish':24B 'published':98B 'rest':32B,106B 'same':140B 'sdmx':30B,38B,104B,112B 'sdmx-ml':37B,111B 'seri':16B,50B,67B 'series':90B,124B,141B 'serv':35B 'serves':109B 'shi':8A,13B,27B,82A,87B,101B 'startperiod':58B,132B 'statist':7A,12B 'statistics':81A,86B 'structur':4A,9B 'structural':78A,83B 'the':92B,100B,123B,139B,143B 'time':15B,89B 'with':127B 'xml':36B,110B 'you':125B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":"eab3ebe3-a519-43d8-a676-4192af61f357","institution_type":"REGULATOR","country_code":"EU","official_confidence":95,"proof_summary":"Official ECB Data Portal dataflow SHI, promoted from the endpoint-verified portal entry","source_seed_url":null,"is_public_sector":true,"published_at":"2026-07-18T21:24:13.966Z","geographic_scope":"EUROPEAN","name_en":null,"description_en":null,"native_lang":null,"access_level":"direct","formats":[],"capability_tier":"live","trust_score":76.25,"merged_into_entry_id":null,"identity_key":"DATASET|https://data-api.ecb.europa.eu/service/data/SHI/all?format=jsondata&lastNObservations=1|european central bank — structural housing indicators statistics (shi)","upstream_ref":null,"access":{"level":"direct","primary":{"kind":"query","label":"List dataflows","method":"GET","url":"https://data-api.ecb.europa.eu/service/dataflow/ECB","source":"query_example","runnable":true,"direct":true},"actions":[{"kind":"query","label":"List dataflows","method":"GET","url":"https://data-api.ecb.europa.eu/service/dataflow/ECB","source":"query_example","runnable":true,"direct":true},{"kind":"query","label":"Run verified request","method":"GET","url":"https://data.ecb.europa.eu/data/datasets/SHI","source":"probe","runnable":true},{"kind":"query","label":"Dataflow structure","method":"GET","url":"https://data-api.ecb.europa.eu/service/dataflow/ECB/SHI?references=all","source":"query_example","runnable":true,"direct":false},{"kind":"query","label":"Fetch observations (JSON)","method":"GET","url":"https://data-api.ecb.europa.eu/service/data/SHI/all?lastNObservations=5&format=jsondata","source":"query_example","runnable":true,"direct":false},{"kind":"landing","label":"Read the docs","method":"GET","url":"https://data.ecb.europa.eu/help/api/overview","source":"docs","runnable":false},{"kind":"landing","label":"Open source record","method":"GET","url":"https://data-api.ecb.europa.eu/service/data/SHI/all?lastNObservations=1&format=jsondata","source":"primary_source","runnable":false}],"formats":[]},"maturity":{"entry_id":"171c0921-db53-4e2b-9fbb-c97d0ae24c44","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":"executable","level_index":4,"level_label":"Executable","meaning":"Queries run through Commodity","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":false,"reached":false,"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":"per_item_proven","label":"Proven for this item: its own proof signals scored >= 80 AND it matched a registered public institution, so it would have been APPROVED on its own evidence.","proof_confidence":95,"proven_threshold":80,"institution_id":"eab3ebe3-a519-43d8-a676-4192af61f357","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":"data-api.ecb.europa.eu","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-02T05:02:02.516Z"},"api_details":null,"dataset_details":null,"license":null,"reuse":{"license_id":null,"license_name":null,"license_url":null,"commercial_use":{"status":"unknown","value":null},"redistribution":{"status":"unknown","value":null},"attribution_required":{"status":"unknown","value":null},"share_alike":{"status":"unknown","value":null},"personal_data_warning":{"status":"unknown","value":null},"cache_and_mirror":{"status":"unknown","value":null},"undetermined":["commercial_use","redistribution","attribution_required","share_alike","personal_data_warning","cache_and_mirror"],"basis":"unverified","confidence":0.1,"confidence_tier":"low","source_text":null,"source_url":null,"reviewed_at":null},"license_raw":null,"latest_check":{"id":"3cf259d9-c9ef-4caa-be66-d0ff37c217a0","entry_id":"171c0921-db53-4e2b-9fbb-c97d0ae24c44","status":"VERIFIED","last_checked_at":"2026-09-01T21:58:03.860Z","p50_latency_ms":4327,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-07-18T21:41:04.343Z","updated_at":"2026-09-01T21:58:03.860Z","consecutive_successes":48,"probe_url":"https://data.ecb.europa.eu/data/datasets/SHI","probe_method":"GET","probe_http_status":200,"probe_content_type":"text/html; charset=UTF-8","probe_succeeded_at":"2026-09-01T21:58:03.860Z"},"data_profile":{"id":"eb2d9aa9-edd5-4f14-9d08-f648a4d24d3c","entry_id":"171c0921-db53-4e2b-9fbb-c97d0ae24c44","profile_source":"sdmx","profile_kind":"dataset","dataset_id":"SHI","fields":[{"name":"FREQ","role":"parameter","type":"dimension","label":"Frequency","param_in":"path","required":true,"filterable":true,"description":"2 codes (e.g. Annual, Quarterly)","enum_values":["A","Q"],"description_en":"Frequency of the observation, e.g. annual or quarterly."},{"name":"REF_AREA","role":"parameter","type":"dimension","label":"Reference area","param_in":"path","required":true,"filterable":true,"description":"33 codes (e.g. Austria, Belgium, Bulgaria)","enum_values":["AT","BE","BG","CY","CZ","DE","DK","EE","ES","FI","FR","GB","GR","HR","HU","I6","I7","I8","IE","IT","LT","LU","LV","MT","NL","PL","PT","RO","SE","SI","SK","V1","V3"],"description_en":"Reference country or area for the observation."},{"name":"SHI_INDICATOR","role":"parameter","type":"dimension","label":"Structural housing indicators","param_in":"path","required":true,"filterable":true,"description":"11 codes (e.g. Number of dwellings, Number of housing completions, Number of housing starts)","enum_values":["DWEL","HCOM","HSTA","HTRA","PRHH","TOOT","TRAP","TRAS","TRAT","VACR","VHTR"],"description_en":"Structural housing indicator being measured, e.g. dwellings or housing starts."},{"name":"SHI_SUFFIX","role":"parameter","type":"dimension","label":"Series variation -SHI context","param_in":"path","required":true,"filterable":true,"description":"2 codes (e.g. Absolute value, Percentage)","enum_values":["A","P"],"description_en":"Indicates whether the value is an absolute figure or a percentage."},{"name":"TIME_PERIOD","role":"parameter","type":"time","label":"Time period or range","param_in":"query","filterable":true,"description":"Time dimension — filter with startPeriod / endPeriod query params.","description_en":"Time period of the observation, filterable by start/end date."},{"name":"OBS_VALUE","role":"field","type":"number","label":"Observation value","description":"The observed numeric value for each cell.","description_en":"Numeric value observed for the series at this period."},{"name":"TIME_FORMAT","role":"field","type":"attribute","label":"Time format code","filterable":false,"description":null,"description_en":"Code specifying the format used for the time period."},{"name":"COLLECTION","role":"field","type":"attribute","label":"Collection indicator","filterable":false,"description":null,"description_en":"Code indicating how the data was collected or aggregated over time."},{"name":"COMPILING_ORG","role":"field","type":"attribute","label":"Compiling organisation","filterable":false,"description":null,"description_en":"Organisation responsible for compiling the data."},{"name":"DISS_ORG","role":"field","type":"attribute","label":"Data dissemination organisation","filterable":false,"description":null,"description_en":"Organisation responsible for disseminating the data."},{"name":"COMPILATION","role":"field","type":"attribute","label":"Compilation","filterable":false,"description":null,"description_en":"Notes on the methodology used to compile the observation."},{"name":"DECIMALS","role":"field","type":"attribute","label":"Decimals","filterable":false,"description":null,"description_en":"Number of decimal places in the observation value."},{"name":"SOURCE_AGENCY","role":"field","type":"attribute","label":"Source agency","filterable":false,"description":null,"description_en":"Agency that originally sourced or provided the data."},{"name":"TITLE","role":"field","type":"attribute","label":"Title","filterable":false,"description":null,"description_en":"Title describing the data series."},{"name":"TITLE_COMPL","role":"field","type":"attribute","label":"Title complement","filterable":false,"description":null,"description_en":"Additional descriptive text complementing the series title."},{"name":"UNIT","role":"field","type":"attribute","label":"Unit","filterable":false,"description":null,"description_en":"Unit of measurement for the observation value."},{"name":"UNIT_MULT","role":"field","type":"attribute","label":"Unit multiplier","filterable":false,"description":null,"description_en":"Power-of-ten multiplier applied to the observation value."},{"name":"OBS_STATUS","role":"field","type":"attribute","label":"Observation status","filterable":false,"description":null,"description_en":"Status flag indicating data quality, e.g. estimated or provisional."},{"name":"OBS_CONF","role":"field","type":"attribute","label":"Observation confidentiality","filterable":false,"description":null,"description_en":"Confidentiality classification of the observation."},{"name":"OBS_PRE_BREAK","role":"field","type":"attribute","label":"Pre-break observation value","filterable":false,"description":null,"description_en":"Value of the observation prior to a break in the time series."},{"name":"OBS_COM","role":"field","type":"attribute","label":"Observation comment","filterable":false,"description":null,"description_en":"Free-text comment or note on the observation."}],"field_count":21,"sample_records":[{"FREQ":"A","REF_AREA":"AT","OBS_VALUE":null,"SHI_SUFFIX":"A","TIME_PERIOD":"2016","SHI_INDICATOR":"DWEL"},{"FREQ":"A","REF_AREA":"AT","OBS_VALUE":56.359,"SHI_SUFFIX":"A","TIME_PERIOD":"2016","SHI_INDICATOR":"HCOM"},{"FREQ":"A","REF_AREA":"AT","OBS_VALUE":75.606,"SHI_SUFFIX":"A","TIME_PERIOD":"2017","SHI_INDICATOR":"HSTA"},{"FREQ":"A","REF_AREA":"AT","OBS_VALUE":78.125,"SHI_SUFFIX":"A","TIME_PERIOD":"2018","SHI_INDICATOR":"HTRA"},{"FREQ":"A","REF_AREA":"AT","OBS_VALUE":3890.092,"SHI_SUFFIX":"A","TIME_PERIOD":"2017","SHI_INDICATOR":"PRHH"}],"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://data-api.ecb.europa.eu/service/dataflow/ECB","curl":"curl -s 'https://data-api.ecb.europa.eu/service/dataflow/ECB' -H 'Accept: application/vnd.sdmx.structure+xml;version=2.1'","label":"List dataflows","method":"GET","description":"All dataflows (datasets) published by this agency, as SDMX-ML."},{"url":"https://data-api.ecb.europa.eu/service/dataflow/ECB/SHI?references=all","curl":"curl -s 'https://data-api.ecb.europa.eu/service/dataflow/ECB/SHI?references=all' -H 'Accept: application/vnd.sdmx.structure+xml;version=2.1'","label":"Dataflow structure","method":"GET","description":"Full structure of the SHI dataflow: dimensions, code lists, attributes."},{"url":"https://data-api.ecb.europa.eu/service/data/SHI/all?lastNObservations=5&format=jsondata","curl":"curl -s 'https://data-api.ecb.europa.eu/service/data/SHI/all?lastNObservations=5&format=jsondata'","label":"Fetch observations (JSON)","method":"GET","description":"Latest observations as SDMX-JSON (the response embeds the dimension structure). Add a key like /data/SHI/D.USD.EUR.SP00.A to select a series."}],"status":"ok","error_message":null,"profiled_at":"2026-07-27T00:29:18.482Z","run_id":"8fb03155-0ec6-4378-bfbc-24d71244b045","created_at":"2026-07-19T21:29:11.657Z","updated_at":"2026-08-05T06:18:26.937Z","license_raw":null,"license_id":null,"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":["OBS_VALUE"],"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":"38422100d98059496c535705bb0ff934c21f41e4e1f050a15704989927f800bc","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":42,"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[] (21 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-02T05:02:52.681Z","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."}}