{"id":"3e928d10-eb70-4d82-8ed0-7be43ef18bd6","type":"DATASET","name":"Deutsche Bundesbank — Securities Issues Statistics (Shares) (BBSHI)","slug":"bundesbank-securities-issues-statistics-shares-bbshi","description":"Securities Issues Statistics (Shares) (BBSHI) — official time series from the Deutsche Bundesbank, published as the BBSHI dataflow over SDMX 2.1 REST. One endpoint serves XML (SDMX-ML), CSV (?format=csv) and JSON (?format=json); extract exactly the series you need with a key path and startPeriod / endPeriod / lastNObservations filters.","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"https://www.bundesbank.de/en/statistics/time-series-databases","docs_url":"https://api.statistiken.bundesbank.de/doc/stat-ws-api-external.yaml","repo_url":null,"status":"ACTIVE","verification_state":"VERIFIED","tags":["economy","prices"],"logo_url":null,"primary_source_url":"https://api.statistiken.bundesbank.de/rest/data/BBSHI?lastNObservations=1&format=json","extraction_confidence":"0.95","created_at":"2026-07-18T21:42:23.735Z","updated_at":"2026-09-02T03:47:33.848Z","last_verified_at":"2026-09-02T03:47:33.848Z","deprecated_at":null,"ranking_score":56,"last_ranked_at":"2026-08-22T05:36:16.907Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":null,"search_vector":"'2.1':27B,86B 'a':109B 'and':98B,112B 'as':80B 'bbshi':7A,12B,23B,66A,71B,82B 'bundesbank':2A,19B,61A,78B 'csv':36B,38B,95B,97B 'dataflow':24B,83B 'deutsch':1A,18B 'deutsche':60A,77B 'economi':58C 'endperiod':55B,114B 'endpoint':30B,89B 'exact':44B 'exactly':103B 'extract':43B,102B 'filter':57B 'filters':116B 'format':37B,41B,96B,100B 'from':75B 'issu':4A,9B 'issues':63A,68B 'json':40B,42B,99B,101B 'key':51B,110B 'lastnobserv':56B 'lastnobservations':115B 'ml':35B,94B 'need':48B,107B 'offici':13B 'official':72B 'one':29B,88B 'over':84B 'path':52B,111B 'price':59C 'publish':20B 'published':79B 'rest':28B,87B 'sdmx':26B,34B,85B,93B 'sdmx-ml':33B,92B 'secur':3A,8B 'securities':62A,67B 'seri':15B,46B 'series':74B,105B 'serv':31B 'serves':90B 'share':6A,11B 'shares':65A,70B 'startperiod':54B,113B 'statist':5A,10B 'statistics':64A,69B 'the':76B,81B,104B 'time':14B,73B 'with':108B 'xml':32B,91B 'you':106B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":null,"institution_type":"REGULATOR","country_code":"DE","official_confidence":null,"proof_summary":"Official Deutsche Bundesbank dataflow BBSHI, promoted from the portal entry","source_seed_url":null,"is_public_sector":true,"published_at":"2026-07-18T21:42:23.735Z","geographic_scope":"NATIONAL","name_en":null,"description_en":null,"native_lang":null,"access_level":"direct","formats":[],"capability_tier":"live","trust_score":49.16666666666667,"merged_into_entry_id":null,"identity_key":"DATASET|https://api.statistiken.bundesbank.de/rest/data/BBSHI?format=json&lastNObservations=1|deutsche bundesbank — securities issues statistics (shares) (bbshi)","upstream_ref":null,"access":{"level":"direct","primary":{"kind":"query","label":"List dataflows","method":"GET","url":"https://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK","source":"query_example","runnable":true,"direct":true},"actions":[{"kind":"query","label":"List dataflows","method":"GET","url":"https://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK","source":"query_example","runnable":true,"direct":true},{"kind":"query","label":"Run verified request","method":"GET","url":"https://api.statistiken.bundesbank.de/rest/data/BBSHI?lastNObservations=1&format=json","source":"probe","runnable":true},{"kind":"query","label":"Dataflow structure","method":"GET","url":"https://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK/BBSHI?references=all","source":"query_example","runnable":true,"direct":false},{"kind":"query","label":"Fetch observations (JSON)","method":"GET","url":"https://api.statistiken.bundesbank.de/rest/data/BBSHI?lastNObservations=5&format=json","source":"query_example","runnable":true,"direct":false},{"kind":"landing","label":"Read the docs","method":"GET","url":"https://api.statistiken.bundesbank.de/doc/stat-ws-api-external.yaml","source":"docs","runnable":false},{"kind":"landing","label":"Visit homepage","method":"GET","url":"https://www.bundesbank.de/en/statistics/time-series-databases","source":"homepage","runnable":false}],"formats":[]},"maturity":{"entry_id":"3e928d10-eb70-4d82-8ed0-7be43ef18bd6","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":"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":null,"proven_threshold":80,"institution_id":null,"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":"api.statistiken.bundesbank.de","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-02T06:56:35.942Z"},"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":"600fbd94-9617-49af-af0e-523ffe8961d4","entry_id":"3e928d10-eb70-4d82-8ed0-7be43ef18bd6","status":"VERIFIED","last_checked_at":"2026-09-02T03:47:33.684Z","p50_latency_ms":3153,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-07-18T23:23:53.102Z","updated_at":"2026-09-02T03:47:33.684Z","consecutive_successes":51,"probe_url":"https://api.statistiken.bundesbank.de/rest/data/BBSHI?lastNObservations=1&format=json","probe_method":"GET","probe_http_status":200,"probe_content_type":"application/json;charset=UTF-8","probe_succeeded_at":"2026-09-02T03:47:33.684Z"},"data_profile":{"id":"8d6d75c6-caa9-4100-9f3c-0210fbffb886","entry_id":"3e928d10-eb70-4d82-8ed0-7be43ef18bd6","profile_source":"sdmx","profile_kind":"dataset","dataset_id":"BBSHI","fields":[{"name":"BBK_STD_FREQ","role":"parameter","type":"dimension","label":"BBK_STD_FREQ","param_in":"path","required":true,"filterable":true,"description":"1 codes (e.g. M)","enum_values":["M"]},{"name":"BBK_SEIS_ITEM","role":"parameter","type":"dimension","label":"BBK_SEIS_ITEM","param_in":"path","required":true,"filterable":true,"description":"5 codes (e.g. ABS, EMK, NAB)","enum_values":["ABS","EMK","NAB","TIL","UML"]},{"name":"BBK_SEIS_VALUATION","role":"parameter","type":"dimension","label":"BBK_SEIS_VALUATION","param_in":"path","required":true,"filterable":true,"description":"4 codes (e.g. KW, NN, DK)","enum_values":["KW","NN","DK","AE"]},{"name":"BBK_SEIS_LISTED_SUB","role":"parameter","type":"dimension","label":"BBK_SEIS_LISTED_SUB","param_in":"path","required":true,"filterable":true,"description":"4 codes (e.g. A, C, F)","enum_values":["A","C","F","B"]},{"name":"BBK_SEIS_ISSUER_CLASS","role":"parameter","type":"dimension","label":"BBK_SEIS_ISSUER_CLASS","param_in":"path","required":true,"filterable":true,"description":"5 codes (e.g. A, S11, S122)","enum_values":["A","S11","S122","X2200","X2300"]},{"name":"BBK_SESS_INDEX","role":"parameter","type":"dimension","label":"BBK_SESS_INDEX","param_in":"path","required":true,"filterable":true,"description":"1 codes (e.g. A)","enum_values":["A"]},{"name":"BBK_SESS_CHANGE","role":"parameter","type":"dimension","label":"BBK_SESS_CHANGE","param_in":"path","required":true,"filterable":true,"description":"7 codes (e.g. _Z, B, K)","enum_values":["_Z","B","K","S","U","V","H"]},{"name":"BBK_SEIS_RATING","role":"parameter","type":"dimension","label":"BBK_SEIS_RATING","param_in":"path","required":true,"filterable":true,"description":"1 codes (e.g. A)","enum_values":["A"]},{"name":"BBK_STD_CURRENCY","role":"parameter","type":"dimension","label":"BBK_STD_CURRENCY","param_in":"path","required":true,"filterable":true,"description":"1 codes (e.g. _T)","enum_values":["_T"]},{"name":"TIME_PERIOD","role":"parameter","type":"time","label":"TIME_PERIOD","param_in":"query","filterable":true,"description":"Time dimension — filter with startPeriod / endPeriod query params."},{"name":"OBS_VALUE","role":"field","type":"number","label":"Observation value","description":"The observed numeric value for each cell."},{"name":"TIME_FORMAT","role":"field","type":"attribute","label":"TIME_FORMAT","filterable":false,"description":null},{"name":"BBK_DECIMALS","role":"field","type":"attribute","label":"BBK_DECIMALS","filterable":false,"description":null},{"name":"BBK_ID","role":"field","type":"attribute","label":"BBK_ID","filterable":false,"description":null},{"name":"BBK_UNIT_ENG","role":"field","type":"attribute","label":"BBK_UNIT_ENG","filterable":false,"description":null},{"name":"BBK_UNIT_MULT","role":"field","type":"attribute","label":"BBK_UNIT_MULT","filterable":false,"description":null},{"name":"BBK_TITLE","role":"field","type":"attribute","label":"BBK_TITLE","filterable":false,"description":null},{"name":"BBK_COMM_GEN_ENG","role":"field","type":"attribute","label":"BBK_COMM_GEN_ENG","filterable":false,"description":null},{"name":"WEB_CATEGORY","role":"field","type":"attribute","label":"WEB_CATEGORY","filterable":false,"description":null},{"name":"OBS_STATUS","role":"field","type":"attribute","label":"OBS_STATUS","filterable":false,"description":null},{"name":"BBK_DIFF","role":"field","type":"attribute","label":"BBK_DIFF","filterable":false,"description":null},{"name":"BBK_DIFF_Y","role":"field","type":"attribute","label":"BBK_DIFF_Y","filterable":false,"description":null},{"name":"BBK_COMM_OBS_ENG","role":"field","type":"attribute","label":"BBK_COMM_OBS_ENG","filterable":false,"description":null}],"field_count":23,"sample_records":[{"OBS_VALUE":"0","TIME_PERIOD":"1948-01","BBK_STD_FREQ":"M","BBK_SEIS_ITEM":"ABS","BBK_SESS_INDEX":"A","BBK_SEIS_RATING":"A","BBK_SESS_CHANGE":"_Z","BBK_STD_CURRENCY":"_T","BBK_SEIS_VALUATION":"KW","BBK_SEIS_LISTED_SUB":"A","BBK_SEIS_ISSUER_CLASS":"A"},{"OBS_VALUE":"0","TIME_PERIOD":"1948-02","BBK_STD_FREQ":"M","BBK_SEIS_ITEM":"ABS","BBK_SESS_INDEX":"A","BBK_SEIS_RATING":"A","BBK_SESS_CHANGE":"_Z","BBK_STD_CURRENCY":"_T","BBK_SEIS_VALUATION":"KW","BBK_SEIS_LISTED_SUB":"A","BBK_SEIS_ISSUER_CLASS":"A"},{"OBS_VALUE":"0","TIME_PERIOD":"1948-03","BBK_STD_FREQ":"M","BBK_SEIS_ITEM":"ABS","BBK_SESS_INDEX":"A","BBK_SEIS_RATING":"A","BBK_SESS_CHANGE":"_Z","BBK_STD_CURRENCY":"_T","BBK_SEIS_VALUATION":"KW","BBK_SEIS_LISTED_SUB":"A","BBK_SEIS_ISSUER_CLASS":"A"},{"OBS_VALUE":"0","TIME_PERIOD":"1948-04","BBK_STD_FREQ":"M","BBK_SEIS_ITEM":"ABS","BBK_SESS_INDEX":"A","BBK_SEIS_RATING":"A","BBK_SESS_CHANGE":"_Z","BBK_STD_CURRENCY":"_T","BBK_SEIS_VALUATION":"KW","BBK_SEIS_LISTED_SUB":"A","BBK_SEIS_ISSUER_CLASS":"A"},{"OBS_VALUE":"0","TIME_PERIOD":"1948-05","BBK_STD_FREQ":"M","BBK_SEIS_ITEM":"ABS","BBK_SESS_INDEX":"A","BBK_SEIS_RATING":"A","BBK_SESS_CHANGE":"_Z","BBK_STD_CURRENCY":"_T","BBK_SEIS_VALUATION":"KW","BBK_SEIS_LISTED_SUB":"A","BBK_SEIS_ISSUER_CLASS":"A"}],"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK","curl":"curl -s 'https://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK' -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://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK/BBSHI?references=all","curl":"curl -s 'https://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK/BBSHI?references=all' -H 'Accept: application/vnd.sdmx.structure+xml;version=2.1'","label":"Dataflow structure","method":"GET","description":"Full structure of the BBSHI dataflow: dimensions, code lists, attributes."},{"url":"https://api.statistiken.bundesbank.de/rest/data/BBSHI?lastNObservations=5&format=json","curl":"curl -s 'https://api.statistiken.bundesbank.de/rest/data/BBSHI?lastNObservations=5&format=json'","label":"Fetch observations (JSON)","method":"GET","description":"Latest observations as SDMX-JSON (the response embeds the dimension structure). Add a key like /data/BBSHI/D.USD.EUR.SP00.A to select a series."}],"status":"ok","error_message":null,"profiled_at":"2026-07-27T00:47:07.220Z","run_id":"8eb3e85d-ccdf-44ab-8fdb-853b6fbc83ff","created_at":"2026-07-19T21:27:35.802Z","updated_at":"2026-07-27T00:47:07.220Z","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":"4b7aac8153edb0e11242c9bfb3f8b145ac5b9c88b9d167a6d7eddfdf404b25e9","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":44,"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[] (23 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-02T06:57:57.987Z","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."}}