Spec

Code snippets

curl "https://api.oanor.com/debtservice-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/debtservice-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/debtservice-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/debtservice-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

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