{"openapi":"3.1.0","info":{"title":"Debt Service Ratio (Debt Burden) API","version":"1.0.0","description":"How much of a country's income goes to servicing debt — interest plus principal — read live from the Bank for International Settlements' open statistics, no key, nothing stored. The credit-to-GDP gap measures how much debt has built up; the debt service ratio (DSR) measures how heavy it is to carry. It is the share of income that borrowers must spend each period just to keep current on their debts, and a high or rising DSR squeezes consumption and investment and has reliably led recessions. The BIS publishes the DSR for households, for non-financial corporations and for the private non-financial sector as a whole. The latest endpoint returns every covered country's most recent DSR for all three sectors; the country endpoint returns one country's household, corporate and total DSR with the reference quarter; the history endpoint returns the quarterly series for a chosen sector. This is the debt-burden / debt-service macro cut — distinct from the credit-to-GDP gap (debt build-up), the credit-growth (lending volumes), the bank-rate, money-supply and FX APIs in the catalogue. A country is a BIS reference area (US, GB, DE, JP …) given as an ISO-2 code or a common name; data is quarterly with the usual statistical lag.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/debtservice-api","description":"oanor gateway"}],"tags":[{"name":"Debt Service"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/country":{"get":{"operationId":"get_v1_country","tags":["Debt Service"],"summary":"One country's household, corporate & total DSR","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"ISO-2 code or common name","schema":{"type":"string"},"example":"US"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Debt service ratios in percent of income. household_dsr (H) is the most-watched read on consumer debt stress; corporate_dsr (N) covers non-financial firms; private_total_dsr (P) is the whole private non-financial sector.","period":"2025-Q3","source":"BIS","country":"US","corporate_dsr":37.8,"household_dsr":7.9,"private_total_dsr":14.1},"meta":{"timestamp":"2026-06-12T10:35:40.612Z","request_id":"e50a0902-a6ad-48a0-adb5-e5777399ed61"},"status":"ok","message":"Country retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/history":{"get":{"operationId":"get_v1_history","tags":["Debt Service"],"summary":"One country's quarterly DSR for a sector","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"ISO-2 code or common name","schema":{"type":"string"},"example":"US"},{"name":"sector","in":"query","required":false,"description":"households (default), corporates or private_total","schema":{"type":"string"},"example":"households"},{"name":"quarters","in":"query","required":false,"description":"Number of recent quarters (2-240, default 40)","schema":{"type":"string"},"example":"40"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":40,"sector":"households","source":"BIS","country":"US","history":[{"dsr":8.1,"period":"2015-Q4"},{"dsr":8.1,"period":"2016-Q1"},{"dsr":8.1,"period":"2016-Q2"},{"dsr":8.2,"period":"2016-Q3"},{"dsr":8.2,"period":"2016-Q4"},{"dsr":8.1,"period":"2017-Q1"},{"dsr":8.1,"period":"2017-Q2"},{"dsr":8.1,"period":"2017-Q3"},{"dsr":8.1,"period":"2017-Q4"},{"dsr":8.1,"period":"2018-Q1"},{"dsr":8.1,"period":"2018-Q2"},{"dsr":8.1,"period":"2018-Q3"},{"dsr":8.1,"period":"2018-Q4"},{"dsr":8,"period":"2019-Q1"},{"dsr":8,"period":"2019-Q2"},{"dsr":8,"period":"2019-Q3"},{"dsr":7.9,"period":"2019-Q4"},{"dsr":7.8,"period":"2020-Q1"},{"dsr":7.5,"period":"2020-Q2"},{"dsr":7.4,"period":"2020-Q3"},{"dsr":7.3,"period":"2020-Q4"},{"dsr":7.1,"period":"2021-Q1"},{"dsr":7.2,"period":"2021-Q2"},{"dsr":7.3,"period":"2021-Q3"},{"dsr":7.3,"period":"2021-Q4"},{"dsr":7.5,"period":"2022-Q1"},{"dsr":7.7,"period":"2022-Q2"},{"dsr":7.9,"period":"2022-Q3"},{"dsr":8,"period":"2022-Q4"},{"dsr":8.1,"period":"2023-Q1"},{"dsr":8.2,"period":"2023-Q2"},{"dsr":8.2,"period":"2023-Q3"},{"dsr":8.1,"period":"2023-Q4"},{"dsr":8,"period":"2024-Q1"},{"dsr":8,"period":"2024-Q2"},{"dsr":8,"period":"2024-Q3"},{"dsr":7.9,"period":"2024-Q4"},{"dsr":7.9,"period":"2025-Q1"},{"dsr":7.9,"period":"2025-Q2"},{"dsr":7.9,"period":"2025-Q3"}]},"meta":{"timestamp":"2026-06-12T10:35:40.751Z","request_id":"70ec4061-75d0-4166-aafa-c136ba743816"},"status":"ok","message":"History retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/latest":{"get":{"operationId":"get_v1_latest","tags":["Debt Service"],"summary":"Every country's latest debt service ratios","description":"","parameters":[{"name":"sort","in":"query","required":false,"description":"Sort: household (default), corporate, total or country","schema":{"type":"string"},"example":"household"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"DSR = share of income spent servicing debt (interest + principal), in percent. household_dsr is for households, corporate_dsr for non-financial corporations, private_total_dsr for the whole private non-financial sector. A high or rising DSR squeezes spending and has led recessions. Sort by household (default), corporate, total or country.","count":17,"source":"BIS","countries":[{"period":"2025-Q3","country":"NO","corporate_dsr":35.8,"household_dsr":20.8,"private_total_dsr":28},{"period":"2025-Q3","country":"AU","corporate_dsr":39.4,"household_dsr":15.6,"private_total_dsr":20.1},{"period":"2025-Q3","country":"CA","corporate_dsr":57.4,"household_dsr":13.9,"private_total_dsr":25.3},{"period":"2025-Q3","country":"NL","corporate_dsr":49.5,"household_dsr":12.9,"private_total_dsr":25.9},{"period":"2025-Q3","country":"DK","corporate_dsr":42.5,"household_dsr":11.8,"private_total_dsr":23.2},{"period":"2025-Q3","country":"SE","corporate_dsr":44,"household_dsr":11.6,"private_total_dsr":23.3},{"period":"2025-Q3","country":"KR","corporate_dsr":37.6,"household_dsr":11.3,"private_total_dsr":19.8},{"period":"2025-Q3","country":"GB","corporate_dsr":27.8,"household_dsr":8.7,"private_total_dsr":13},{"period":"2025-Q3","country":"US","corporate_dsr":37.8,"household_dsr":7.9,"private_total_dsr":14.1},{"period":"2025-Q3","country":"FI","corporate_dsr":41.9,"household_dsr":7.7,"private_total_dsr":18.4},{"period":"2025-Q3","country":"JP","corporate_dsr":31.9,"household_dsr":7.4,"private_total_dsr":15.3},{"period":"2025-Q3","country":"BE","corporate_dsr":37,"household_dsr":7,"private_total_dsr":17},{"period":"2025-Q3","country":"FR","corporate_dsr":59.1,"household_dsr":5.9,"private_total_dsr":20.5},{"period":"2025-Q3","country":"PT","corporate_dsr":39.5,"household_dsr":5.8,"private_total_dsr":12.3},{"period":"2025-Q3","country":"DE","corporate_dsr":33,"household_dsr":5.4,"private_total_dsr":12.4},{"period":"2025-Q3","country":"ES","corporate_dsr":31.9,"household_dsr":5.2,"private_total_dsr":11.8},{"period":"2025-Q3","country":"IT","corporate_dsr":25.7,"household_dsr":4.2,"private_total_dsr":9.1}],"latest_quarter":"2025-Q3"},"meta":{"timestamp":"2026-06-12T10:35:40.948Z","request_id":"b7b11d44-86a3-4ed6-9fe6-723d5e5ccbc8"},"status":"ok","message":"Latest retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"country is an ISO-2 code (US, DE, GB, JP) or a common name. history sector is households (default), corporates or private_total. history quarters is 2-240 (default 40). Quarterly data with the usual statistical lag; briefly cached.","source":"BIS Data Portal (stats.bis.org/api/v2, WS_DSR, quarterly, live)","sectors":["households","corporates","private_total"],"service":"debtservice-api","countries":17,"endpoints":{"GET /v1/meta":"This document.","GET /v1/latest":"Every country's latest household/corporate/total DSR, sortable (sort=household|corporate|total|country).","GET /v1/country":"One country's household, corporate and total debt service ratio (country=US).","GET /v1/history":"One country's quarterly DSR for a sector (country=US, sector=households, quarters=40)."},"description":"Debt service ratio (DSR) — how much of a country's income goes to servicing debt, from the BIS open statistics (no key, nothing stored). The DSR is the share of income spent on interest plus principal; a high or rising DSR squeezes consumption and has led recessions. latest returns every country's most recent DSR for households, corporates and the private sector; country returns one country's three sector DSRs; history returns a chosen sector's quarterly series. The debt-burden / debt-service macro cut — distinct from the credit-to-GDP gap (debt build-up), credit-growth (lending volumes), bank-rate, money-supply and FX APIs.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T10:35:41.037Z","request_id":"cb625c9b-eb14-460e-970f-685ba5877211"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":700,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":944,"monthly_call_quota":16800,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2766,"monthly_call_quota":86000,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":6460,"monthly_call_quota":460000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/debtservice-api"}