Deutsche Bundesbank — Direct investment positions (publication level) (BBFFDIPV)
Direct investment positions at publication level (BBFFDIPV) is an official time series dataflow published by the Deutsche Bundesbank via its SDMX 2.1 REST API. It provides data on Germany's direct investment positions, part of the balance-of-payments and international investment statistics maintained by the Bundesbank. A single endpoint serves the data in XML (SDMX-ML), CSV, or JSON formats, and users can retrieve specific series using a key path together with startPeriod, endPeriod, or lastNObservations filters. Useful for economic and financial analysis of German cross-border investment.Direct investment positions (publication level) (BBFFDIPV) — official time series from the Deutsche Bundesbank, published as the BBFFDIPV 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.
Trust score
How is this computed?Weighted across five axes. Tap a ring for what it measures.
Data schema (29 fields)
Click a field to see example values.
| Field | Type | Description |
|---|---|---|
| BBK_STD_FREQ | dimension | Frequency of the time series, e.g. annual.1 codes (e.g. A) |
| BBK_ES_MEASURE_PRINCIPLE | dimension | Measurement principle applied, e.g. directional or asset/liability.2 codes (e.g. DI, DO) |
| BBK_ES_AREA_REFERENCE | dimension | Reference geographic area code, e.g. Germany or a German state.17 codes (e.g. DE, DEBB00, DEBE00) |
| BBK_ES_AREA_COUNTERPART | dimension | Counterpart country or area code for the investment relationship.256 codes (e.g. A1, A2, A5) |
| BBK_ES_SECTOR_REFERENCE | dimension | Institutional sector of the reference economy.1 codes (e.g. S1) |
| BBK_ES_LEVEL_COUNTERPART | dimension | Level of the counterpart relationship, e.g. immediate or ultimate investor.4 codes (e.g. IMC, PSC, ULT) |
| BBK_ES_FLOW_STOCK_ENTRY | dimension | Indicates whether the entry is a flow or stock position.1 codes (e.g. LE) |
| BBK_ES_ACCOUNTING_ENTRY | dimension | Accounting entry type, e.g. assets, liabilities or net.5 codes (e.g. A, L, NI) |
| BBK_ES_ACCOUNTING_ITEM | dimension | Balance-of-payments accounting item, e.g. financial account.1 codes (e.g. FA) |
| BBK_ES_FUNCTIONAL_CAT | dimension | Functional category of investment, e.g. direct investment, equity or debt.4 codes (e.g. D, EMP, ENT) |
| BBK_ES_INSTR_ASSET | dimension | Financial instrument or asset category code.2 codes (e.g. F, _Z) |
| BBK_ES_TYPE_ENTITY | dimension | Type of reporting entity covered.1 codes (e.g. ALL) |
| BBK_ES_MEASURE_UNIT | dimension | Unit in which the value is measured, e.g. euro.2 codes (e.g. EUR, _AN) |
| BBK_ES_FDI_RELATIONSHIP | dimension | Type of foreign direct investment relationship.1 codes (e.g. I) |
| BBK_ES_VALUATION | dimension | Valuation method applied to the reported figures.2 codes (e.g. V, _Z) |
| BBK_ES_STAT_UNIT | dimension | Statistical unit classification code.1 codes (e.g. _X) |
| BBK_ES_ACTIVITY | dimension | Economic activity or industry classification code.115 codes (e.g. _T, A, A01) |
| BBK_ES_ACTIVITY_ALLOC | dimension | Method used to allocate the economic activity.3 codes (e.g. _Z, 2, 1) |
| TIME_PERIOD | time | Time period of the observation; filterable via startPeriod/endPeriod.Time dimension — filter with startPeriod / endPeriod query params. |
| OBS_VALUEObservation value | number | Observed numeric value for the data point.The observed numeric value for each cell. |
| TIME_FORMAT | attribute | Format code describing how the time period is expressed.Format code describing how the time period is expressed. |
| BBK_DECIMALS | attribute | Number of decimal places in the observation value.Number of decimal places in the observation value. |
| BBK_ID | attribute | Bundesbank internal identifier for the series.Bundesbank internal identifier for the series. |
| BBK_UNIT | attribute | Unit of measurement used by the Bundesbank for the series.Unit of measurement used by the Bundesbank for the series. |
| BBK_UNIT_MULT | attribute | Multiplier applied to the unit, e.g. thousands or millions.Multiplier applied to the unit, e.g. thousands or millions. |
| BBK_TITLE_ENG | attribute | English-language title of the series.English-language title of the series. |
| WEB_CATEGORY | attribute | Bundesbank website category classification for the series.Bundesbank website category classification for the series. |
| BBK_DIFF_Y | attribute | Year-on-year percentage change of the value.Year-on-year percentage change of the value. |
| OBS_STATUS | attribute | Status flag indicating data quality, e.g. estimated or provisional.Status flag indicating data quality, e.g. estimated or provisional. |
Schema captured from sdmx 2 days 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.
Sample data (5 records)
Record 1OBS_VALUE: 20332 · BBK_DIFF_Y: —
{
"OBS_VALUE": "20332",
"BBK_DIFF_Y": null,
"OBS_STATUS": null,
"TIME_PERIOD": "2010",
"BBK_STD_FREQ": "A",
"BBK_ES_ACTIVITY": "_T",
"BBK_ES_STAT_UNIT": "_X",
"BBK_ES_VALUATION": "V",
"BBK_ES_INSTR_ASSET": "F",
"BBK_ES_TYPE_ENTITY": "ALL",
"BBK_ES_MEASURE_UNIT": "EUR",
"BBK_ES_ACTIVITY_ALLOC": "_Z",
"BBK_ES_AREA_REFERENCE": "DE",
"BBK_ES_FUNCTIONAL_CAT": "D",
"BBK_ES_ACCOUNTING_ITEM": "FA",
"BBK_ES_ACCOUNTING_ENTRY": "A",
"BBK_ES_AREA_COUNTERPART": "A1",
"BBK_ES_FDI_RELATIONSHIP": "I",
"BBK_ES_FLOW_STOCK_ENTRY": "LE",
"BBK_ES_SECTOR_REFERENCE": "S1",
"BBK_ES_LEVEL_COUNTERPART": "IMC",
"BBK_ES_MEASURE_PRINCIPLE": "DI"
}Record 2OBS_VALUE: 26011 · BBK_DIFF_Y: 27.9
{
"OBS_VALUE": "26011",
"BBK_DIFF_Y": "27.9",
"OBS_STATUS": null,
"TIME_PERIOD": "2011",
"BBK_STD_FREQ": "A",
"BBK_ES_ACTIVITY": "_T",
"BBK_ES_STAT_UNIT": "_X",
"BBK_ES_VALUATION": "V",
"BBK_ES_INSTR_ASSET": "F",
"BBK_ES_TYPE_ENTITY": "ALL",
"BBK_ES_MEASURE_UNIT": "EUR",
"BBK_ES_ACTIVITY_ALLOC": "_Z",
"BBK_ES_AREA_REFERENCE": "DE",
"BBK_ES_FUNCTIONAL_CAT": "D",
"BBK_ES_ACCOUNTING_ITEM": "FA",
"BBK_ES_ACCOUNTING_ENTRY": "A",
"BBK_ES_AREA_COUNTERPART": "A1",
"BBK_ES_FDI_RELATIONSHIP": "I",
"BBK_ES_FLOW_STOCK_ENTRY": "LE",
"BBK_ES_SECTOR_REFERENCE": "S1",
"BBK_ES_LEVEL_COUNTERPART": "IMC",
"BBK_ES_MEASURE_PRINCIPLE": "DI"
}Record 3OBS_VALUE: 22728 · BBK_DIFF_Y: -12.6
{
"OBS_VALUE": "22728",
"BBK_DIFF_Y": "-12.6",
"OBS_STATUS": null,
"TIME_PERIOD": "2012",
"BBK_STD_FREQ": "A",
"BBK_ES_ACTIVITY": "_T",
"BBK_ES_STAT_UNIT": "_X",
"BBK_ES_VALUATION": "V",
"BBK_ES_INSTR_ASSET": "F",
"BBK_ES_TYPE_ENTITY": "ALL",
"BBK_ES_MEASURE_UNIT": "EUR",
"BBK_ES_ACTIVITY_ALLOC": "_Z",
"BBK_ES_AREA_REFERENCE": "DE",
"BBK_ES_FUNCTIONAL_CAT": "D",
"BBK_ES_ACCOUNTING_ITEM": "FA",
"BBK_ES_ACCOUNTING_ENTRY": "A",
"BBK_ES_AREA_COUNTERPART": "A1",
"BBK_ES_FDI_RELATIONSHIP": "I",
"BBK_ES_FLOW_STOCK_ENTRY": "LE",
"BBK_ES_SECTOR_REFERENCE": "S1",
"BBK_ES_LEVEL_COUNTERPART": "IMC",
"BBK_ES_MEASURE_PRINCIPLE": "DI"
}Record 4OBS_VALUE: 21945 · BBK_DIFF_Y: -3.4
{
"OBS_VALUE": "21945",
"BBK_DIFF_Y": "-3.4",
"OBS_STATUS": null,
"TIME_PERIOD": "2013",
"BBK_STD_FREQ": "A",
"BBK_ES_ACTIVITY": "_T",
"BBK_ES_STAT_UNIT": "_X",
"BBK_ES_VALUATION": "V",
"BBK_ES_INSTR_ASSET": "F",
"BBK_ES_TYPE_ENTITY": "ALL",
"BBK_ES_MEASURE_UNIT": "EUR",
"BBK_ES_ACTIVITY_ALLOC": "_Z",
"BBK_ES_AREA_REFERENCE": "DE",
"BBK_ES_FUNCTIONAL_CAT": "D",
"BBK_ES_ACCOUNTING_ITEM": "FA",
"BBK_ES_ACCOUNTING_ENTRY": "A",
"BBK_ES_AREA_COUNTERPART": "A1",
"BBK_ES_FDI_RELATIONSHIP": "I",
"BBK_ES_FLOW_STOCK_ENTRY": "LE",
"BBK_ES_SECTOR_REFERENCE": "S1",
"BBK_ES_LEVEL_COUNTERPART": "IMC",
"BBK_ES_MEASURE_PRINCIPLE": "DI"
}Record 5OBS_VALUE: 25379 · BBK_DIFF_Y: 15.6
{
"OBS_VALUE": "25379",
"BBK_DIFF_Y": "15.6",
"OBS_STATUS": null,
"TIME_PERIOD": "2014",
"BBK_STD_FREQ": "A",
"BBK_ES_ACTIVITY": "_T",
"BBK_ES_STAT_UNIT": "_X",
"BBK_ES_VALUATION": "V",
"BBK_ES_INSTR_ASSET": "F",
"BBK_ES_TYPE_ENTITY": "ALL",
"BBK_ES_MEASURE_UNIT": "EUR",
"BBK_ES_ACTIVITY_ALLOC": "_Z",
"BBK_ES_AREA_REFERENCE": "DE",
"BBK_ES_FUNCTIONAL_CAT": "D",
"BBK_ES_ACCOUNTING_ITEM": "FA",
"BBK_ES_ACCOUNTING_ENTRY": "A",
"BBK_ES_AREA_COUNTERPART": "A1",
"BBK_ES_FDI_RELATIONSHIP": "I",
"BBK_ES_FLOW_STOCK_ENTRY": "LE",
"BBK_ES_SECTOR_REFERENCE": "S1",
"BBK_ES_LEVEL_COUNTERPART": "IMC",
"BBK_ES_MEASURE_PRINCIPLE": "DI"
}Live sample captured at profiling time — values may have changed upstream.
Verification Status
Using the API
Query examples
curl -s 'https://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK' -H 'Accept: application/vnd.sdmx.structure+xml;version=2.1'All dataflows (datasets) published by this agency, as SDMX-ML.
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.