{"openapi":"3.1.0","info":{"title":"Debt-to-GDP by Sector API","version":"1.0.0","description":"How indebted each economy's government, households and companies are relative to the size of the economy, read live from the Bank for International Settlements' open statistics — no key, nothing stored. Debt-to-GDP is the headline gauge of debt sustainability: how big a borrower's debts are versus the income that has to service them. The BIS publishes total credit as a share of GDP for the general government, for households, for non-financial corporations and for the private non-financial sector as a whole, on a consistent cross-country basis. The latest endpoint returns every covered country's most recent government, household, corporate and total-private debt-to-GDP; the country endpoint returns one country's four sector ratios with the reference quarter; the history endpoint returns a chosen sector's quarterly series. This is the debt-level / leverage macro cut — distinct from the credit-to-GDP gap (how stretched credit is versus its trend), the debt service ratio (the cost of carrying that debt), the credit-growth (lending volumes), bank-rate 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/debttogdp-api","description":"oanor gateway"}],"tags":[{"name":"Debt-to-GDP"},{"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-to-GDP"],"summary":"One country's four sector debt ratios","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-to-GDP in percent. government is general-government debt; households and corporates (non-financial) are the private sub-sectors; private_total is the whole private non-financial sector. From BIS total credit at market value.","period":"2025-Q3","source":"BIS","country":"US","corporates":72.5,"government":109.7,"households":68,"private_total":140.4},"meta":{"timestamp":"2026-06-12T10:35:37.719Z","request_id":"ca9514d4-3e2d-4569-b0c1-6f060c2cba69"},"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-to-GDP"],"summary":"One country's quarterly debt-to-GDP 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":"government (default), households, corporates or private_total","schema":{"type":"string"},"example":"government"},{"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":"government","source":"BIS","country":"US","history":[{"period":"2015-Q4","debt_to_gdp":99.6},{"period":"2016-Q1","debt_to_gdp":102.6},{"period":"2016-Q2","debt_to_gdp":103.3},{"period":"2016-Q3","debt_to_gdp":103.2},{"period":"2016-Q4","debt_to_gdp":100.6},{"period":"2017-Q1","debt_to_gdp":99.6},{"period":"2017-Q2","debt_to_gdp":98.7},{"period":"2017-Q3","debt_to_gdp":99.2},{"period":"2017-Q4","debt_to_gdp":99.4},{"period":"2018-Q1","debt_to_gdp":99.1},{"period":"2018-Q2","debt_to_gdp":97.5},{"period":"2018-Q3","debt_to_gdp":96.7},{"period":"2018-Q4","debt_to_gdp":98.9},{"period":"2019-Q1","debt_to_gdp":100.5},{"period":"2019-Q2","debt_to_gdp":100.7},{"period":"2019-Q3","debt_to_gdp":103.7},{"period":"2019-Q4","debt_to_gdp":103.5},{"period":"2020-Q1","debt_to_gdp":110.7},{"period":"2020-Q2","debt_to_gdp":125.1},{"period":"2020-Q3","debt_to_gdp":127.3},{"period":"2020-Q4","debt_to_gdp":129.3},{"period":"2021-Q1","debt_to_gdp":125.4},{"period":"2021-Q2","debt_to_gdp":121.9},{"period":"2021-Q3","debt_to_gdp":119.3},{"period":"2021-Q4","debt_to_gdp":119.1},{"period":"2022-Q1","debt_to_gdp":113.9},{"period":"2022-Q2","debt_to_gdp":107},{"period":"2022-Q3","debt_to_gdp":102.1},{"period":"2022-Q4","debt_to_gdp":101.5},{"period":"2023-Q1","debt_to_gdp":103},{"period":"2023-Q2","debt_to_gdp":101.6},{"period":"2023-Q3","debt_to_gdp":101},{"period":"2023-Q4","debt_to_gdp":105.5},{"period":"2024-Q1","debt_to_gdp":105.2},{"period":"2024-Q2","debt_to_gdp":103.6},{"period":"2024-Q3","debt_to_gdp":107.7},{"period":"2024-Q4","debt_to_gdp":106.3},{"period":"2025-Q1","debt_to_gdp":107.7},{"period":"2025-Q2","debt_to_gdp":106.3},{"period":"2025-Q3","debt_to_gdp":109.7}]},"meta":{"timestamp":"2026-06-12T10:35:37.856Z","request_id":"06fac834-35e0-4c7b-af36-b06aad6f425c"},"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-to-GDP"],"summary":"Every country's debt-to-GDP by sector","description":"","parameters":[{"name":"sort","in":"query","required":false,"description":"Sort: government (default), households, corporates, private_total or country","schema":{"type":"string"},"example":"government"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Debt-to-GDP in percent (BIS total credit at market value, all lenders). government is general-government debt, households and corporates are the private sub-sectors, private_total is the whole private non-financial sector. Sort by government (default), households, corporates, private_total or country.","count":32,"source":"BIS","countries":[{"period":"2025-Q3","country":"JP","corporates":111.7,"government":184.3,"households":61.1,"private_total":172.8},{"period":"2025-Q3","country":"GR","corporates":57.5,"government":150.9,"households":38.2,"private_total":95.7},{"period":"2025-Q3","country":"IT","corporates":58.5,"government":137.9,"households":35.9,"private_total":94.4},{"period":"2025-Q3","country":"FR","corporates":155.2,"government":110,"households":59.9,"private_total":215.1},{"period":"2025-Q3","country":"US","corporates":72.5,"government":109.7,"households":68,"private_total":140.4},{"period":"2025-Q3","country":"5R","corporates":90.9,"government":101.5,"households":68.5,"private_total":159.4},{"period":"2025-Q3","country":"ES","corporates":77,"government":100.7,"households":43,"private_total":120},{"period":"2025-Q3","country":"BE","corporates":117.8,"government":99.4,"households":56.6,"private_total":174.5},{"period":"2025-Q3","country":"CA","corporates":118,"government":96.2,"households":100.2,"private_total":218.2},{"period":"2025-Q3","country":"PT","corporates":75.8,"government":95.9,"households":53.4,"private_total":129.2},{"period":"2025-Q3","country":"5A","corporates":93.5,"government":95.4,"households":60.2,"private_total":153.6},{"period":"2025-Q3","country":"G2","corporates":92.5,"government":95.2,"households":59.5,"private_total":152},{"period":"2025-Q3","country":"GB","corporates":59.1,"government":86,"households":73.9,"private_total":133},{"period":"2025-Q3","country":"XM","corporates":103.4,"government":86,"households":50.6,"private_total":154},{"period":"2025-Q3","country":"FI","corporates":114.9,"government":81,"households":63.2,"private_total":178.1},{"period":"2025-Q3","country":"AT","corporates":84.4,"government":77.5,"households":42.1,"private_total":126.4},{"period":"2025-Q3","country":"IL","corporates":71.3,"government":73.9,"households":42.7,"private_total":114},{"period":"2025-Q3","country":"HU","corporates":67.8,"government":72.9,"households":17.7,"private_total":85.5},{"period":"2025-Q3","country":"DE","corporates":89.5,"government":58.7,"households":49.1,"private_total":138.6},{"period":"2025-Q3","country":"PL","corporates":35.1,"government":57.2,"households":22.3,"private_total":57.4},{"period":"2025-Q3","country":"AU","corporates":62,"government":51.4,"households":113.2,"private_total":175.2},{"period":"2025-Q3","country":"KR","corporates":110.9,"government":47.7,"households":89.4,"private_total":200.2},{"period":"2025-Q3","country":"CL","corporates":90.5,"government":41.6,"households":44.2,"private_total":134.7},{"period":"2025-Q3","country":"CZ","corporates":51.6,"government":41.6,"households":31.2,"private_total":82.8},{"period":"2025-Q3","country":"NO","corporates":134.1,"government":41.4,"households":86.1,"private_total":220.1},{"period":"2025-Q3","country":"NL","corporates":166.9,"government":39.8,"households":93.8,"private_total":260.8},{"period":"2025-Q3","country":"SE","corporates":153,"government":32.8,"households":83.1,"private_total":236.1},{"period":"2025-Q3","country":"IE","corporates":94,"government":30.4,"households":23.9,"private_total":117.9},{"period":"2025-Q3","country":"DK","corporates":138.1,"government":28.4,"households":84.2,"private_total":222.2},{"period":"2025-Q3","country":"LU","corporates":367.5,"government":26.7,"households":61.8,"private_total":429.2},{"period":"2025-Q3","country":"CH","corporates":128.3,"government":25.9,"households":121.9,"private_total":250.2},{"period":"2025-Q3","country":"TR","corporates":38.8,"government":24.4,"households":9.8,"private_total":48.6}],"latest_quarter":"2025-Q3"},"meta":{"timestamp":"2026-06-12T10:35:38.094Z","request_id":"454330c6-b89e-4f2f-b296-62943afab04c"},"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 government (default), households, corporates or private_total. history quarters is 2-240 (default 40). Total credit at market value, all lenders, % of GDP. Quarterly with the usual lag; briefly cached.","source":"BIS Data Portal (stats.bis.org/api/v2, WS_TC, quarterly, live)","sectors":["government","households","corporates","private_total"],"service":"debttogdp-api","countries":32,"endpoints":{"GET /v1/meta":"This document.","GET /v1/latest":"Every country's government/household/corporate/total-private debt-to-GDP, sortable (sort=government|households|corporates|private_total|country).","GET /v1/country":"One country's four sector debt-to-GDP ratios (country=US).","GET /v1/history":"One country's quarterly debt-to-GDP for a sector (country=US, sector=government, quarters=40)."},"description":"Debt-to-GDP by sector — how indebted each economy's government, households and companies are, from the BIS open statistics (no key, nothing stored). latest returns every country's government, household, corporate and total-private debt-to-GDP; country returns one country's four sector ratios; history returns a sector's quarterly series. The debt-level / leverage macro cut — distinct from the credit-to-GDP gap (stretch vs trend), the debt service ratio (cost of carrying debt), credit-growth (lending volumes), bank-rate and FX APIs.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T10:35:38.187Z","request_id":"369f61bf-d0f9-4470-b08b-3f295cc9b142"},"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":888,"monthly_call_quota":18500,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2688,"monthly_call_quota":90000,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":6260,"monthly_call_quota":470000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/debttogdp-api"}