Usage notes

Code snippets

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

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

$ch = curl_init("https://api.oanor.com/dbnomics-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/dbnomics-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": "Economic time series aggregated from 90+ official providers (IMF, OECD, Eurostat, ECB, World Bank, BIS, the US Fed & BLS, national statistics offices…). /v1/providers (filter query=) = the data providers with their code and region; /v1/search?query=inflation (filter provider=Eurostat) = search datasets across all providers, returning each dataset's provider, code, name and series count; /v1/dataset?provider=Eurostat&code=une_rt_m = a dataset's details and its dimensions (the codes you combine to pick a series); /v1/series?provider=Eurostat&dataset=une_rt_m (or add series=M.NSA.TOTAL.PC_ACT.F.AT for one) = the series with their observations (period & value) and the latest data point. Typical flow: search → dataset → series. For World-Bank-specific indicators by country see the World Bank API.",
        "source": "DBnomics API (api.db.nomics.world) — economic data from 90+ providers",
        "endpoints": [
            "/v1/providers",
            "/v1/search",
            "/v1/dataset",
            "/v1/series",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T08:13:39.140Z",
        "request_id": "18cc4638-d43d-4f0b-aae7-a62118208a77"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}