{"id":"feaa8116-2fa4-45fe-8fcb-5f56341453b9","type":"DATASET","name":"European Central Bank — Shipments of Euro Banknotes Statistics (ESCB) (BNT)","slug":"ecb-shipments-of-euro-banknotes-statistics-escb-bnt","description":"Shipments of Euro Banknotes Statistics (ESCB) (BNT) — official time series from the European Central Bank Data Portal, published as the BNT 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/BNT","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/BNT/all?lastNObservations=1&format=jsondata","extraction_confidence":"0.95","created_at":"2026-07-18T21:24:09.081Z","updated_at":"2026-09-01T18:45:01.894Z","last_verified_at":"2026-09-01T18:45:01.894Z","deprecated_at":null,"ranking_score":61,"last_ranked_at":"2026-08-22T09:42:14.589Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":null,"search_vector":"'2.1':35B,109B,204B,278B 'a':227B,281B,302B 'across':93B,262B 'allow':126B 'allowing':295B 'also':147B,316B 'analysi':162B 'analysis':331B 'and':216B,230B,236B,319B,329B 'api':111B,280B 'as':198B,271B 'bank':3A,25B,85B,99B,172A,194B,254B 'banknot':7A,14B,92B,166B 'banknote':335B 'banknotes':176A,183B,261B 'banks':268B 'be':317B 'bnt':10A,17B,31B,104B,179A,186B,200B,273B 'brows':66B,149B 'browse':235B 'browsed':318B 'can':315B 'central':2A,24B,84B,98B,171A,193B,253B,267B 'chart':68B,151B,237B 'charted':320B 'cover':88B 'covering':257B 'csv':44B,122B,213B,291B 'csvdata':46B,215B 'data':26B,75B,86B,116B,156B,195B,244B,255B,285B,325B 'dataflow':32B,105B,201B,274B 'dataset':80B,249B 'ecb':74B,155B,243B,324B 'econom':161B 'economi':168C 'economic':330B 'endperiod':63B,139B,232B,308B 'endpoint':38B,114B,207B,283B 'escb':9A,16B,100B,178A,185B,269B 'euro':6A,13B,91B,165B,175A,182B,260B,334B 'european':1A,23B,83B,95B,170A,192B,252B,264B 'exact':52B 'exactly':221B 'extract':51B,129B,220B,298B 'filter':65B,142B 'filters':234B,311B 'format':45B,49B,125B,214B,218B 'formats':294B 'from':190B,250B 'in':286B 'interact':152B 'interactively':321B 'json':48B,124B,217B,293B 'jsondata':50B,219B 'key':59B,134B,228B,303B 'lastnobserv':64B,141B 'lastnobservations':233B,310B 'logist':167B 'logistics':336B 'ml':43B,121B,212B,290B 'monetari':159B 'monetary':328B 'need':56B,225B 'of':174A,181B,259B,266B 'offici':18B,77B 'official':187B,246B 'on':241B,322B 'one':37B,206B 'or':292B,309B 'over':202B 'path':60B,135B,229B,304B 'portal':27B,76B,87B,157B,196B,245B,256B,326B 'price':169C 'publish':28B,101B 'published':197B,270B 'relat':163B 'related':332B 'rest':36B,110B,205B,279B 'same':239B,313B 'sdmx':34B,42B,108B,120B,203B,211B,277B,289B 'sdmx-ml':41B,119B,210B,288B 'seri':20B,54B,71B,79B,131B,145B 'series':189B,223B,240B,248B,300B,314B 'serv':39B,115B 'serves':208B,284B 'shipment':4A,11B,89B 'shipments':173A,180B,258B 'singl':113B 'single':282B 'specif':130B 'specific':299B 'startperiod':62B,138B,231B,307B 'statist':8A,15B 'statistics':177A,184B 'support':158B 'supporting':327B 'system':96B,265B 'the':191B,199B,222B,238B,242B,251B,263B,272B,276B,312B,323B 'time':19B,78B,188B,247B 'to':297B,333B 'togeth':136B 'together':305B 'use':132B 'user':127B 'users':296B 'using':301B 'via':106B,275B 'with':226B,306B 'xml':40B,118B,209B,287B 'you':224B","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 BNT, promoted from the endpoint-verified portal entry","source_seed_url":null,"is_public_sector":true,"published_at":"2026-07-18T21:24:09.081Z","geographic_scope":"EUROPEAN","name_en":null,"description_en":"Official time series dataset from the European Central Bank Data Portal covering shipments of euro banknotes across the European System of Central Banks (ESCB), published as the BNT dataflow via the SDMX 2.1 REST API. A single endpoint serves data in XML (SDMX-ML), CSV, or JSON formats, allowing users to extract specific series using a key path together with startPeriod, endPeriod, or lastNObservations filters. The same series can also be browsed and charted interactively on the ECB Data Portal, supporting monetary and economic analysis related to euro banknote logistics.","native_lang":"en","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/BNT/all?format=jsondata&lastNObservations=1|european central bank — shipments of euro banknotes statistics (escb) (bnt)","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/BNT","source":"probe","runnable":true},{"kind":"query","label":"Dataflow structure","method":"GET","url":"https://data-api.ecb.europa.eu/service/dataflow/ECB/BNT?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/BNT/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/BNT/all?lastNObservations=1&format=jsondata","source":"primary_source","runnable":false}],"formats":[]},"maturity":{"entry_id":"feaa8116-2fa4-45fe-8fcb-5f56341453b9","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:06:10.060Z"},"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":"570d0691-f8bb-47b7-9497-7333c6205dd7","entry_id":"feaa8116-2fa4-45fe-8fcb-5f56341453b9","status":"VERIFIED","last_checked_at":"2026-09-01T18:45:01.656Z","p50_latency_ms":3875,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-07-18T21:40:53.305Z","updated_at":"2026-09-01T18:45:01.656Z","consecutive_successes":61,"probe_url":"https://data.ecb.europa.eu/data/datasets/BNT","probe_method":"GET","probe_http_status":200,"probe_content_type":"text/html; charset=UTF-8","probe_succeeded_at":"2026-09-01T18:45:01.656Z"},"data_profile":{"id":"700469f5-cb90-4a06-8316-1e77f51978dc","entry_id":"feaa8116-2fa4-45fe-8fcb-5f56341453b9","profile_source":"sdmx","profile_kind":"dataset","dataset_id":"BNT","fields":[{"name":"FREQ","role":"parameter","type":"dimension","label":"Frequency","param_in":"path","required":true,"filterable":true,"description":"1 codes (e.g. Monthly)","enum_values":["M"],"description_en":"Code indicating the observation frequency, e.g. monthly."},{"name":"REF_AREA","role":"parameter","type":"dimension","label":"Reference area","param_in":"path","required":true,"filterable":true,"description":"1 codes (e.g. Euro area (Member States and Institutions of the Euro Area) changing composition)","enum_values":["U2"],"description_en":"Code for the reference geographic or economic area covered."},{"name":"ADJUSTMENT","role":"parameter","type":"dimension","label":"Adjustment indicator","param_in":"path","required":true,"filterable":true,"description":"2 codes (e.g. Neither seasonally nor working day adjusted, Working day and seasonally adjusted)","enum_values":["N","Y"],"description_en":"Indicates whether the series is seasonally and/or working-day adjusted."},{"name":"DATA_TYPE_BOP","role":"parameter","type":"dimension","label":"Data type - BoP related data","param_in":"path","required":true,"filterable":true,"description":"3 codes (e.g. Credit transactions, Debit transactions, Net transactions)","enum_values":["2","3","4"],"description_en":"Type of balance-of-payments related transaction: credit, debit or net."},{"name":"BKN_DENOM","role":"parameter","type":"dimension","label":"BKN denomination breakdown","param_in":"path","required":true,"filterable":true,"description":"1 codes (e.g. All denominations)","enum_values":["ALLD"],"description_en":"Banknote denomination breakdown covered by the series."},{"name":"COUNT_AREA","role":"parameter","type":"dimension","label":"Counterpart area","param_in":"path","required":true,"filterable":true,"description":"1 codes (e.g. Rest of the World)","enum_values":["W1"],"description_en":"Code for the counterpart area involved in the transaction."},{"name":"SERIES_DENOM","role":"parameter","type":"dimension","label":"Series denominat/spec calcul","param_in":"path","required":true,"filterable":true,"description":"1 codes (e.g. Euro)","enum_values":["E"],"description_en":"Currency or unit in which the series values are denominated."},{"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 via date range parameters."},{"name":"OBS_VALUE","role":"field","type":"number","label":"Observation value","description":"The observed numeric value for each cell.","description_en":"Numeric value of the statistical observation."},{"name":"TIME_FORMAT","role":"field","type":"attribute","label":"Time format code","filterable":false,"description":null,"description_en":"Code specifying the format used to express the time period."},{"name":"BREAKS","role":"field","type":"attribute","label":"Breaks","filterable":false,"description":null,"description_en":"Indicates any structural breaks in the time series."},{"name":"COLLECTION","role":"field","type":"attribute","label":"Collection indicator","filterable":false,"description":null,"description_en":"Indicator describing how the data was collected."},{"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":"PUBL_ECB","role":"field","type":"attribute","label":"Source publication (ECB only)","filterable":false,"description":null,"description_en":"Reference to the source publication issued by the ECB."},{"name":"PUBL_MU","role":"field","type":"attribute","label":"Source publication (Euro area only)","filterable":false,"description":null,"description_en":"Reference to the source publication for the euro area."},{"name":"PUBL_PUBLIC","role":"field","type":"attribute","label":"Source publication (public)","filterable":false,"description":null,"description_en":"Reference to the publicly available source publication."},{"name":"AGG_EQUN","role":"field","type":"attribute","label":"Aggregation equations","filterable":false,"description":null,"description_en":"Equation or formula used to derive the aggregated value."},{"name":"COMPILATION","role":"field","type":"attribute","label":"Compilation","filterable":false,"description":null,"description_en":"Notes on the methodology used to compile the data."},{"name":"DECIMALS","role":"field","type":"attribute","label":"Decimals","filterable":false,"description":null,"description_en":"Number of decimal places used in the observation value."},{"name":"SOURCE_AGENCY","role":"field","type":"attribute","label":"Source agency","filterable":false,"description":null,"description_en":"Code identifying the agency that is the original data source."},{"name":"TITLE","role":"field","type":"attribute","label":"Title","filterable":false,"description":null,"description_en":"Short title describing the data series."},{"name":"TITLE_COMPL","role":"field","type":"attribute","label":"Title complement","filterable":false,"description":null,"description_en":"Additional descriptive text supplementing the series title."},{"name":"UNIT","role":"field","type":"attribute","label":"Unit","filterable":false,"description":null,"description_en":"Unit of measurement used 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 code 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":"Observation value prior to a recorded time series break."},{"name":"OBS_COM","role":"field","type":"attribute","label":"Observation comment","filterable":false,"description":null,"description_en":"Free-text comment attached to the observation."}],"field_count":29,"sample_records":[{"FREQ":"M","REF_AREA":"U2","BKN_DENOM":"ALLD","OBS_VALUE":1649.5987278124433,"ADJUSTMENT":"N","COUNT_AREA":"W1","TIME_PERIOD":"2026-05","SERIES_DENOM":"E","DATA_TYPE_BOP":"2"},{"FREQ":"M","REF_AREA":"U2","BKN_DENOM":"ALLD","OBS_VALUE":4288.830000000001,"ADJUSTMENT":"N","COUNT_AREA":"W1","TIME_PERIOD":"2026-05","SERIES_DENOM":"E","DATA_TYPE_BOP":"3"},{"FREQ":"M","REF_AREA":"U2","BKN_DENOM":"ALLD","OBS_VALUE":-2639.231272187558,"ADJUSTMENT":"N","COUNT_AREA":"W1","TIME_PERIOD":"2026-05","SERIES_DENOM":"E","DATA_TYPE_BOP":"4"},{"FREQ":"M","REF_AREA":"U2","BKN_DENOM":"ALLD","OBS_VALUE":-2860.41238862512,"ADJUSTMENT":"Y","COUNT_AREA":"W1","TIME_PERIOD":"2026-05","SERIES_DENOM":"E","DATA_TYPE_BOP":"4"}],"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/BNT?references=all","curl":"curl -s 'https://data-api.ecb.europa.eu/service/dataflow/ECB/BNT?references=all' -H 'Accept: application/vnd.sdmx.structure+xml;version=2.1'","label":"Dataflow structure","method":"GET","description":"Full structure of the BNT dataflow: dimensions, code lists, attributes."},{"url":"https://data-api.ecb.europa.eu/service/data/BNT/all?lastNObservations=5&format=jsondata","curl":"curl -s 'https://data-api.ecb.europa.eu/service/data/BNT/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/BNT/D.USD.EUR.SP00.A to select a series."}],"status":"ok","error_message":null,"profiled_at":"2026-07-27T03:50:42.157Z","run_id":"901a14d2-76cf-4264-8b4f-1446380c9173","created_at":"2026-07-20T03:47:41.598Z","updated_at":"2026-08-05T06:15:16.223Z","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":["COUNT_AREA","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":"6d9ed0f3e047bd30aa2c80563cea132d7725df23e351f3f1940e80c07ebb7612","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":49,"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-02T05:06:31.204Z","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."}}