{"id":"a0b42176-fa0c-4e04-9dfe-405b3ee4a2f7","type":"DATASET","name":"Deutsche Bundesbank — German external trade (BBDA1)","slug":"bundesbank-german-external-trade-bbda1","description":"German external trade (BBDA1) — official time series from the Deutsche Bundesbank, published as the BBDA1 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":"FAILING","tags":["economy","prices"],"logo_url":null,"primary_source_url":"https://api.statistiken.bundesbank.de/rest/data/BBDA1?lastNObservations=1&format=json","extraction_confidence":"0.95","created_at":"2026-07-18T21:42:08.875Z","updated_at":"2026-09-01T21:37:21.671Z","last_verified_at":"2026-08-31T20:14:00.173Z","deprecated_at":null,"ranking_score":39,"last_ranked_at":"2026-08-22T05:37:20.549Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":null,"search_vector":"'2.1':25B,76B,161B,212B 'a':184B,215B,231B,240B 'allow':114B 'allowing':250B 'analysi':123B 'analysis':259B 'and':173B,187B,247B,261B 'api':78B,214B 'as':155B,205B 'bbda1':6A,10B,21B,71B,142A,146B,157B,207B 'bundesbank':2A,17B,68B,138A,153B,204B 'by':201B 'can':235B 'csv':34B,36B,89B,170B,172B,225B 'data':59B,83B,195B,219B 'dataflow':22B,72B,158B,208B 'deliv':82B 'delivers':218B 'deutsch':1A,16B,67B 'deutsche':137A,152B,203B 'econom':122B 'economi':135C 'economic':258B 'endperiod':53B,110B,189B,246B 'endpoint':28B,81B,164B,217B 'exact':42B 'exactly':178B 'extern':4A,8B,62B 'external':140A,144B,198B 'extract':41B,100B,177B,236B 'filter':55B,113B 'filters':191B,249B 'for':256B 'foreign':130B,266B 'format':35B,39B,92B,96B,171B,175B,232B 'formats':228B 'from':150B 'german':3A,7B,61B,139A,143B,197B 'germani':128B 'germany':264B 'in':220B 'its':210B 'json':38B,40B,91B,174B,176B,227B 'key':49B,105B,185B,241B 'lastnobserv':54B,112B 'lastnobservations':190B,248B 'ml':33B,88B,169B,224B 'monitor':126B 'monitoring':262B 'nation':121B 'national':257B 'need':46B,182B 'of':253B,263B 'offici':11B,56B 'official':147B,192B 'on':196B 'one':27B,163B 'or':226B 'over':159B,269B 'paramet':97B 'parameter':233B 'path':50B,106B,186B,242B 'perform':132B 'performance':268B 'price':136C 'publish':18B,64B 'published':154B,200B 'research':124B,260B 'rest':26B,77B,162B,213B 'retriev':116B 'retrieval':252B 's':265B 'sdmx':24B,32B,75B,87B,160B,168B,211B,223B 'sdmx-ml':31B,86B,167B,222B 'select':93B 'selectable':229B 'seri':13B,44B,58B,102B 'series':149B,180B,194B,238B 'serv':29B 'serves':165B 'singl':80B 'single':216B 'specif':101B 'specific':237B 'startperiod':52B,109B,188B,245B 'statist':119B 'statistics':255B 'target':115B 'targeted':251B 'the':151B,156B,179B,202B,206B 'through':209B 'time':12B,57B,134B,148B,193B,270B 'togeth':107B 'together':243B 'trade':5A,9B,63B,118B,131B,141A,145B,199B,254B,267B 'use':103B 'user':98B 'users':234B 'using':239B 'via':94B,230B 'with':183B,244B 'xml':30B,85B,166B,221B 'you':181B","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 BBDA1, promoted from the portal entry","source_seed_url":null,"is_public_sector":true,"published_at":"2026-07-18T21:42:08.875Z","geographic_scope":"NATIONAL","name_en":null,"description_en":"Official time series data on German external trade, published by the Deutsche Bundesbank as the BBDA1 dataflow through its SDMX 2.1 REST API. A single endpoint delivers data in XML (SDMX-ML), CSV, or JSON formats, selectable via a format parameter. Users can extract specific series using a key path together with startPeriod, endPeriod, and lastNObservations filters, allowing targeted retrieval of trade statistics for national economic analysis, research, and monitoring of Germany's foreign trade performance over time.","native_lang":"en","access_level":"direct","formats":[],"capability_tier":"live","trust_score":34.16666666666667,"merged_into_entry_id":null,"identity_key":"DATASET|https://api.statistiken.bundesbank.de/rest/data/BBDA1?format=json&lastNObservations=1|deutsche bundesbank — german external trade (bbda1)","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/BBDA1?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/BBDA1?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/BBDA1?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":"a0b42176-fa0c-4e04-9dfe-405b3ee4a2f7","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":"discovered","level_index":1,"level_label":"Discovered","meaning":"Source and metadata recorded","counts_as_coverage":false,"blocked_by":"verified","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":false,"reached":false,"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":false,"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":false,"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-02T10:54:37.716Z"},"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":"2bed1f8a-9cea-49c9-9f08-75dff72fb030","entry_id":"a0b42176-fa0c-4e04-9dfe-405b3ee4a2f7","status":"FAILING","last_checked_at":"2026-09-01T18:11:07.556Z","p50_latency_ms":2236,"p95_latency_ms":null,"last_error":"Distribution check returned HTTP 413","consecutive_failures":1,"created_at":"2026-07-19T03:20:52.224Z","updated_at":"2026-09-01T18:11:07.556Z","consecutive_successes":0,"probe_url":"https://api.statistiken.bundesbank.de/rest/data/BBDA1?lastNObservations=1&format=json","probe_method":"GET","probe_http_status":200,"probe_content_type":"application/json;charset=UTF-8","probe_succeeded_at":"2026-08-31T20:13:59.990Z"},"data_profile":{"id":"ef61fc62-f823-4df3-adde-36e384614aaa","entry_id":"a0b42176-fa0c-4e04-9dfe-405b3ee4a2f7","profile_source":"sdmx","profile_kind":"dataset","dataset_id":"BBDA1","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_STD_AREA_WORLD","role":"parameter","type":"dimension","label":"BBK_STD_AREA_WORLD","param_in":"path","required":true,"filterable":true,"description":"1 codes (e.g. DE)","enum_values":["DE"]},{"name":"BBK_STD_ADJUSTMENT","role":"parameter","type":"dimension","label":"BBK_STD_ADJUSTMENT","param_in":"path","required":true,"filterable":true,"description":"2 codes (e.g. N, Y)","enum_values":["N","Y"]},{"name":"BBK_DOET_DIRECTION","role":"parameter","type":"dimension","label":"BBK_DOET_DIRECTION","param_in":"path","required":true,"filterable":true,"description":"3 codes (e.g. EX, IM, SD)","enum_values":["EX","IM","SD"]},{"name":"BBK_DOET_CONCEPT","role":"parameter","type":"dimension","label":"BBK_DOET_CONCEPT","param_in":"path","required":true,"filterable":true,"description":"1 codes (e.g. S)","enum_values":["S"]},{"name":"BBK_DOET_CLASSIFICATION","role":"parameter","type":"dimension","label":"BBK_DOET_CLASSIFICATION","param_in":"path","required":true,"filterable":true,"description":"11 codes (e.g. A, GP09I028, GP09I029)","enum_values":["A","GP09I028","GP09I029","GP09IS02","GP09IS03","GP09IS04","GP09IS09","GP09IS10","GP09IS07","GP09IS11","GP09IS12"]},{"name":"BBK_DOET_DESTINATION","role":"parameter","type":"dimension","label":"BBK_DOET_DESTINATION","param_in":"path","required":true,"filterable":true,"description":"42 codes (e.g. A1, AT, AU)","enum_values":["A1","AT","AU","B0","BR","CH","CN","CZ","DK","E1","ESXES1","F1","FI","FR","G4","GB","HU","IE","IT","JP","K3","KR","NL","NO","O1","P0","PL","PT","R1","R5","RU","S1","S19805","S3","S6","SE","SK","TR","U2","US","W1","W100X2"]},{"name":"BBK_DOET_INCO","role":"parameter","type":"dimension","label":"BBK_DOET_INCO","param_in":"path","required":true,"filterable":true,"description":"1 codes (e.g. A)","enum_values":["A"]},{"name":"BBK_PRICEUNIT","role":"parameter","type":"dimension","label":"BBK_PRICEUNIT","param_in":"path","required":true,"filterable":true,"description":"2 codes (e.g. V, C)","enum_values":["V","C"]},{"name":"BBK_DO_BASIS","role":"parameter","type":"dimension","label":"BBK_DO_BASIS","param_in":"path","required":true,"filterable":true,"description":"2 codes (e.g. ABA, A21)","enum_values":["ABA","A21"]},{"name":"BBK_DO_SUFFIX","role":"parameter","type":"dimension","label":"BBK_DO_SUFFIX","param_in":"path","required":true,"filterable":true,"description":"2 codes (e.g. A, L)","enum_values":["A","L"]},{"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_ENG","role":"field","type":"attribute","label":"BBK_TITLE_ENG","filterable":false,"description":null},{"name":"BBK_COMM_SRC_ENG","role":"field","type":"attribute","label":"BBK_COMM_SRC_ENG","filterable":false,"description":null},{"name":"WEB_CATEGORY","role":"field","type":"attribute","label":"WEB_CATEGORY","filterable":false,"description":null},{"name":"BBK_COMM_METH_ENG","role":"field","type":"attribute","label":"BBK_COMM_METH_ENG","filterable":false,"description":null},{"name":"BBK_COMM_GEN_ENG","role":"field","type":"attribute","label":"BBK_COMM_GEN_ENG","filterable":false,"description":null},{"name":"BBK_UMR_ENG","role":"field","type":"attribute","label":"BBK_UMR_ENG","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":"OBS_STATUS","role":"field","type":"attribute","label":"OBS_STATUS","filterable":false,"description":null},{"name":"BBK_DIFF_A","role":"field","type":"attribute","label":"BBK_DIFF_A","filterable":false,"description":null},{"name":"BBK_DIFF_Y_A","role":"field","type":"attribute","label":"BBK_DIFF_Y_A","filterable":false,"description":null}],"field_count":29,"sample_records":[{"OBS_VALUE":"4278238","TIME_PERIOD":"1993-01","BBK_DO_BASIS":"ABA","BBK_STD_FREQ":"M","BBK_DOET_INCO":"A","BBK_DO_SUFFIX":"A","BBK_PRICEUNIT":"V","BBK_DOET_CONCEPT":"S","BBK_DOET_DIRECTION":"EX","BBK_STD_ADJUSTMENT":"N","BBK_STD_AREA_WORLD":"DE","BBK_DOET_DESTINATION":"A1","BBK_DOET_CLASSIFICATION":"A"},{"OBS_VALUE":"5349564","TIME_PERIOD":"1993-02","BBK_DO_BASIS":"ABA","BBK_STD_FREQ":"M","BBK_DOET_INCO":"A","BBK_DO_SUFFIX":"A","BBK_PRICEUNIT":"V","BBK_DOET_CONCEPT":"S","BBK_DOET_DIRECTION":"EX","BBK_STD_ADJUSTMENT":"N","BBK_STD_AREA_WORLD":"DE","BBK_DOET_DESTINATION":"A1","BBK_DOET_CLASSIFICATION":"A"},{"OBS_VALUE":"5729405","TIME_PERIOD":"1993-03","BBK_DO_BASIS":"ABA","BBK_STD_FREQ":"M","BBK_DOET_INCO":"A","BBK_DO_SUFFIX":"A","BBK_PRICEUNIT":"V","BBK_DOET_CONCEPT":"S","BBK_DOET_DIRECTION":"EX","BBK_STD_ADJUSTMENT":"N","BBK_STD_AREA_WORLD":"DE","BBK_DOET_DESTINATION":"A1","BBK_DOET_CLASSIFICATION":"A"},{"OBS_VALUE":"4995931","TIME_PERIOD":"1993-04","BBK_DO_BASIS":"ABA","BBK_STD_FREQ":"M","BBK_DOET_INCO":"A","BBK_DO_SUFFIX":"A","BBK_PRICEUNIT":"V","BBK_DOET_CONCEPT":"S","BBK_DOET_DIRECTION":"EX","BBK_STD_ADJUSTMENT":"N","BBK_STD_AREA_WORLD":"DE","BBK_DOET_DESTINATION":"A1","BBK_DOET_CLASSIFICATION":"A"},{"OBS_VALUE":"5024839","TIME_PERIOD":"1993-05","BBK_DO_BASIS":"ABA","BBK_STD_FREQ":"M","BBK_DOET_INCO":"A","BBK_DO_SUFFIX":"A","BBK_PRICEUNIT":"V","BBK_DOET_CONCEPT":"S","BBK_DOET_DIRECTION":"EX","BBK_STD_ADJUSTMENT":"N","BBK_STD_AREA_WORLD":"DE","BBK_DOET_DESTINATION":"A1","BBK_DOET_CLASSIFICATION":"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/BBDA1?references=all","curl":"curl -s 'https://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK/BBDA1?references=all' -H 'Accept: application/vnd.sdmx.structure+xml;version=2.1'","label":"Dataflow structure","method":"GET","description":"Full structure of the BBDA1 dataflow: dimensions, code lists, attributes."},{"url":"https://api.statistiken.bundesbank.de/rest/data/BBDA1?lastNObservations=5&format=json","curl":"curl -s 'https://api.statistiken.bundesbank.de/rest/data/BBDA1?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/BBDA1/D.USD.EUR.SP00.A to select a series."}],"status":"ok","error_message":null,"profiled_at":"2026-07-27T02:15:25.838Z","run_id":"99346c9e-897d-4344-86d1-009a1386c7a9","created_at":"2026-07-19T21:32:06.878Z","updated_at":"2026-07-27T02:15:25.838Z","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":"8a68b1de15733a79cfce97ed2629da68dd9a600a2477e6d83a4a9b71ba4d2106","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":50,"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[] (29 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-02T10:54:41.851Z","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."}}