European Central Bank — Shipments of Euro Banknotes Statistics (ESCB) (BNT)

DatasetExecutable4/7Query nowOpen workbench Subscribe🇪🇺European

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.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.

economyprices

Run verified request Dataflow structure Fetch observations (JSON)Read the docs Open source record

Data schema (29 fields)

Filterable via the API (8)

FREQREF_AREAADJUSTMENTDATA_TYPE_BOPBKN_DENOMCOUNT_AREASERIES_DENOMTIME_PERIOD

Click a field to see example values.

Field	Type	Description
FREQFrequency	dimension	Code indicating the observation frequency, e.g. monthly.1 codes (e.g. Monthly)
REF_AREAReference area	dimension	Code for the reference geographic or economic area covered.1 codes (e.g. Euro area (Member States and Institutions of the Euro Area) changing composition)
ADJUSTMENTAdjustment indicator	dimension	Indicates whether the series is seasonally and/or working-day adjusted.2 codes (e.g. Neither seasonally nor working day adjusted, Working day and seasonally adjusted)
DATA_TYPE_BOPData type - BoP related data	dimension	Type of balance-of-payments related transaction: credit, debit or net.3 codes (e.g. Credit transactions, Debit transactions, Net transactions)
BKN_DENOMBKN denomination breakdown	dimension	Banknote denomination breakdown covered by the series.1 codes (e.g. All denominations)
COUNT_AREACounterpart area	dimension	Code for the counterpart area involved in the transaction.1 codes (e.g. Rest of the World)
SERIES_DENOMSeries denominat/spec calcul	dimension	Currency or unit in which the series values are denominated.1 codes (e.g. Euro)
TIME_PERIODTime period or range	time	Time period of the observation; filterable via date range parameters.Time dimension — filter with startPeriod / endPeriod query params.
OBS_VALUEObservation value	number	Numeric value of the statistical observation.The observed numeric value for each cell.
TIME_FORMATTime format code	attribute	Code specifying the format used to express the time period.Code specifying the format used to express the time period.
BREAKS	attribute	Indicates any structural breaks in the time series.Indicates any structural breaks in the time series.
COLLECTIONCollection indicator	attribute	Indicator describing how the data was collected.Indicator describing how the data was collected.
COMPILING_ORGCompiling organisation	attribute	Organisation responsible for compiling the data.Organisation responsible for compiling the data.
DISS_ORGData dissemination organisation	attribute	Organisation responsible for disseminating the data.Organisation responsible for disseminating the data.
PUBL_ECBSource publication (ECB only)	attribute	Reference to the source publication issued by the ECB.Reference to the source publication issued by the ECB.
PUBL_MUSource publication (Euro area only)	attribute	Reference to the source publication for the euro area.Reference to the source publication for the euro area.
PUBL_PUBLICSource publication (public)	attribute	Reference to the publicly available source publication.Reference to the publicly available source publication.
AGG_EQUNAggregation equations	attribute	Equation or formula used to derive the aggregated value.Equation or formula used to derive the aggregated value.
COMPILATION	attribute	Notes on the methodology used to compile the data.Notes on the methodology used to compile the data.
DECIMALS	attribute	Number of decimal places used in the observation value.Number of decimal places used in the observation value.
SOURCE_AGENCY	attribute	Code identifying the agency that is the original data source.Code identifying the agency that is the original data source.
TITLE	attribute	Short title describing the data series.Short title describing the data series.
TITLE_COMPLTitle complement	attribute	Additional descriptive text supplementing the series title.Additional descriptive text supplementing the series title.
UNIT	attribute	Unit of measurement used for the observation value.Unit of measurement used for the observation value.
UNIT_MULTUnit multiplier	attribute	Power-of-ten multiplier applied to the observation value.Power-of-ten multiplier applied to the observation value.
OBS_STATUSObservation status	attribute	Status code indicating data quality, e.g. estimated or provisional.Status code indicating data quality, e.g. estimated or provisional.
OBS_CONFObservation confidentiality	attribute	Confidentiality classification of the observation.Confidentiality classification of the observation.
OBS_PRE_BREAKPre-break observation value	attribute	Observation value prior to a recorded time series break.Observation value prior to a recorded time series break.
OBS_COMObservation comment	attribute	Free-text comment attached to the observation.Free-text comment attached to the observation.

Schema captured from sdmx 1 month ago.

Query the data

Pick columns and a sort, then fetch a live preview straight from the source. Choose an API-filterable column (marked ▾) under “Where” to pick from its list of values.

Where=

Sort by

Sample data (4 records)

Record 1FREQ: M · REF_AREA: U2

{
  "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"
}

Record 2FREQ: M · REF_AREA: U2

{
  "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"
}

Record 3FREQ: M · REF_AREA: U2

{
  "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"
}

Record 4FREQ: M · REF_AREA: U2

{
  "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"
}

Live sample captured at profiling time — values may have changed upstream.

Verification Status

Using the API

Query examples

curl -s 'https://data-api.ecb.europa.eu/service/dataflow/ECB' -H 'Accept: application/vnd.sdmx.structure+xml;version=2.1'

All dataflows (datasets) published by this agency, as SDMX-ML.

Full API documentation ↗

Machine-readable & source

JSON

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.