Aggregated NBFI + bank debt holdings per country (5-sector sum)

GET

/api/v1/cross/total-nbfi/by-country/{slug}

Last modified:2026-05-10 09:22:45

Maintainer:Not configured

OperationId:cross_total_nbfi_by_country_slug

Sums S122 banks + S123 MMF + S124 investment funds + S128 insurance + S129 pension debt holdings per period for one country. Cross-store join across W6 SHSS S124 and D SHSS multi-sector helpers - composes their public APIs without a separate ingest path or schema bump.

MIN-anchored upper period bound + best-effort fill below ensures per-sector publication skew does not produce a sawtooth right-edge or strict-all-5 history truncation. Each row's n_sectors_with_data field surfaces how many sectors contributed to that period's total.

include_breakdown=false drops per-sector values from each row (smaller payload, less transparency). Cached 5 minutes via cache_async_lock_for double-check (mirror of /cross/transatlantic).

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/cross/total-nbfi/by-country/lu?include_breakdown=undefined&periods=undefined' \
--header 'x-api-key: <api-key>'

Responses

🟢200

application/json

Aggregated NBFI/bank debt holdings timeseries for one country with MIN-anchored upper period bound + per-sector breakdown by default.

Bodyapplication/json

Example

{
    "data": {
        "country": "LU",
        "name": "Luxembourg",
        "upper_period": "2025-Q4",
        "coverage": {
            "S122_banks": "string",
            "S123_mmf": "string",
            "S124_funds": "string",
            "S128_insurance": "string",
            "S129_pension": "string"
        },
        "data_partial": false,
        "missing_sectors": [],
        "rows_count": 20,
        "rows": [
            {
                "period": "2025-Q4",
                "total_eur_mn": 5641135,
                "n_sectors_with_data": 5,
                "breakdown": {
                    "S122_banks": 0,
                    "S123_mmf": 0,
                    "S124_funds": 0,
                    "S128_insurance": 0,
                    "S129_pension": 0
                }
            }
        ]
    },
    "meta": {
        "endpoint": "/api/v1/fred/us/cpi",
        "data_time": "2026-04-16T14:30:00Z",
        "response_time": "2026-04-16T14:30:12Z",
        "provider": "Sugra API v1.0.1",
        "source": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true
    }
}

🟠401

🟠422

🟠429

🔴503

Modified at 2026-05-10 09:22:45

One country's historical TIC holdings timeseries

Search LEI records by legal name, country, and status