DBnomics

App · 11 actions

Pull economic and financial time series from about 90 statistics offices, central banks and international organisations (the IMF, OECD, Eurostat, ECB, BIS, World Bank, the Fed and national statistics offices) through one source: GDP, inflation, unemployment, interest rates, exchange rates and more. Find datasets and series, read values between two dates or just the latest one, and start a workflow when new data is published. No account or API key required.

Actions

ActionWhat it does
Get a datasetGet one dataset's details: what it holds, how many series, what its series vary by (its dimensions, such as country and indicator), when DBnomics last updated it and when the provider plans its next release.
Get a dataset's dimensionsList what a dataset's series vary by (country, indicator, frequency, unit...) with every value's code and name: the codes List series filters by and series IDs are made of.
Get a providerGet one provider's details: its website and terms of use, how many datasets it publishes on DBnomics and how they are grouped (such as Economy and finance, or Population).
Get latest values for several seriesGet the latest value of up to 50 series at once, from any providers (say inflation, unemployment and the policy rate of several countries), for a dashboard or a regular report.
Get series observationsGet a time series' values between two dates, such as GDP growth or inflation over the last ten years, as rows of period, start date and value, with its latest value.
Get the latest valueGet a time series' most recent value (the latest inflation rate, interest rate or exchange rate) with its period, the value before it and the change between them, ready to put in a message.
List a provider's datasetsList the datasets a provider publishes, in its own catalogue's order and with the group each is filed under, optionally only those whose name contains some text.
List providersSee every statistics office, central bank and international organisation DBnomics collects data from (about 90, such as the IMF, Eurostat and the Fed), with its region, website, terms of use and when its data last changed.
List recently updated datasetsSee which datasets DBnomics loaded new data for most recently, newest first: across every provider or for one, and optionally only since a date.
List series in a datasetFind the series in a dataset: narrow them by dimension (a country, an indicator, a frequency...) and by words in their names, and optionally get each one's latest value.
Search datasetsSearch every provider's datasets by words in their names, descriptions and series, such as unemployment France, and see how many of each dataset's series match.

Get a dataset

Get one dataset's details: what it holds, how many series, what its series vary by (its dimensions, such as country and indicator), when DBnomics last updated it and when the provider plans its next release.

Inputs

Providerprovider_codetextRequired
The statistics office, central bank or organisation that publishes the data.
Datasetdataset_codetextRequired
The dataset. Pick it once a provider is chosen, or type its code, like CPI.

Outputs

datasetobject
A dataset and what it holds.
Example output
{
  "dataset": {
    "code": "CPI",
    "description": "Consumer price indexes (CPIs) are index numbers that measure changes in the prices of goods and services purchased or otherwise acquired by households.",
    "dimensions": [
      {
        "code": "FREQ",
        "label": "Frequency",
        "value_count": 6
      },
      {
        "code": "REF_AREA",
        "label": "Reference Area",
        "value_count": 237
      },
      {
        "code": "INDICATOR",
        "label": "Indicator",
        "value_count": 178
      }
    ],
    "discontinued": false,
    "documentation_url": null,
    "id": "IMF/CPI",
    "last_updated_at": "2025-08-31T11:54:51Z",
    "name": "Consumer Price Index (CPI)",
    "next_release_at": null,
    "notes": [
      "Code: CPI",
      "Temporal Coverage: Monthly, quarterly and annual data."
    ],
    "provider_code": "IMF",
    "provider_name": "International Monetary Fund",
    "series_count": 29801,
    "source_updated_at": "2025-08-30",
    "source_url": null,
    "url": "https://db.nomics.world/IMF/CPI"
  }
}

Get a dataset's dimensions

List what a dataset's series vary by (country, indicator, frequency, unit...) with every value's code and name: the codes List series filters by and series IDs are made of.

Inputs

Providerprovider_codetextRequired
The statistics office, central bank or organisation that publishes the data.
Datasetdataset_codetextRequired
The dataset. Pick it once a provider is chosen, or type its code, like CPI.
Dimensiondimensiontext
Only this dimension. Leave empty for all of them.
Search valuessearchtext
Only values whose name or code contains this, e.g. France.
Values per dimensionmax_valuesnumber
The most values to list for each dimension, 1 to 5,000. 200 by default; the result says how many more there are.From 1 to 5000. Default: 200.

Outputs

countnumber
How many dimensions are listed.
dataset_idtext
The dataset's ID, e.g. IMF/CPI.
dataset_nametext
The dataset's name.
dimensionslist
The dimensions, in the order series codes use them.
searchtext
The value search that was applied, if any.
Example output
{
  "count": 1,
  "dataset_id": "IMF/CPI",
  "dataset_name": "Consumer Price Index (CPI)",
  "dimensions": [
    {
      "code": "REF_AREA",
      "label": "Reference Area",
      "matching_count": 1,
      "value_count": 237,
      "values": [
        {
          "code": "FR",
          "label": "France"
        }
      ],
      "values_left_out": 0
    }
  ],
  "search": "France"
}

Get a provider

Get one provider's details: its website and terms of use, how many datasets it publishes on DBnomics and how they are grouped (such as Economy and finance, or Population).

Inputs

Providerprovider_codetextRequired
The statistics office, central bank or organisation that publishes the data.

Outputs

providerobject
A statistics office, central bank or organisation DBnomics collects from.
Example output
{
  "provider": {
    "categories": [
      {
        "dataset_count": 38,
        "name": "Not in a category"
      },
      {
        "dataset_count": 68,
        "name": "World Economic Outlook"
      }
    ],
    "code": "IMF",
    "dataset_count": 106,
    "last_updated_at": "2025-09-04T02:25:25Z",
    "name": "International Monetary Fund",
    "region": "World",
    "terms_of_use_url": "http://datahelp.imf.org/tos",
    "url": "https://db.nomics.world/IMF",
    "website": "https://www.imf.org/"
  }
}

Get latest values for several series

Get the latest value of up to 50 series at once, from any providers (say inflation, unemployment and the policy rate of several countries), for a dashboard or a regular report. Says which IDs DBnomics does not have.

Inputs

SeriesserieslistRequired
Up to 50 series, from any providers, each as its ID or the address of its page on db.nomics.world, like IMF/CPI/A.FR.PCPI_IX.

Outputs

countnumber
How many series were found.
not_foundlist
The series IDs DBnomics does not have.
not_found_countnumber
How many series IDs were not found.
serieslist
Each series found, in the order given.
Example output
{
  "count": 1,
  "not_found": [],
  "not_found_count": 0,
  "series": [
    {
      "change": -2.8793078422,
      "dataset_code": "CPI",
      "dataset_name": "Consumer Price Index (CPI)",
      "date": "2024-01-01",
      "frequency": "Annual",
      "has_value": true,
      "last_updated_at": "2025-08-31T11:54:51Z",
      "percent_change": -59.0221,
      "period": "2024",
      "previous_date": "2023-01-01",
      "previous_period": "2023",
      "previous_value": 4.87835726508438,
      "provider_code": "IMF",
      "provider_name": null,
      "series_id": "IMF/CPI/A.FR.PCPI_PC_CP_A_PT",
      "series_name": "Annual \u2013 France \u2013 Consumer Price Index, All items, Percentage change, Previous year",
      "url": "https://db.nomics.world/IMF/CPI/A.FR.PCPI_PC_CP_A_PT",
      "value": 1.99904942291464
    }
  ]
}

Get series observations

Get a time series' values between two dates, such as GDP growth or inflation over the last ten years, as rows of period, start date and value, with its latest value. Says what was left out: periods with no value, and the oldest ones past Maximum observations.

Inputs

Providerprovider_codetext
The provider, to pick the series from a list. Leave empty when Series is a full ID or a link.
Datasetdataset_codetext
The dataset, to pick the series from a list. Leave empty when Series is a full ID or a link.
SeriesseriestextRequired
The series. Pick it from the list (a dataset's first 500 series), or paste its ID or the address of its page on db.nomics.world, like IMF/CPI/A.FR.PCPI_IX. List series finds the ID of any other.
Fromfrom_datedate
Only periods that end on or after this date. The period the date falls in is included: for a quarterly series, 15 Feb 2024 means 2024-Q1.
Toto_datedate
Only periods that start on or before this date.
Orderordertext
Oldest first by default.One of: oldest_first (Oldest first), newest_first (Newest first). Default: oldest_first.
Include periods with no valueinclude_missingtrue/false
Also return periods the provider has no value for, with an empty value. Off by default.Default: false.
Maximum observationsmax_observationsnumber
The most observations to return, 1 to 10,000; the most recent are kept. 1,000 by default.From 1 to 10000. Default: 1000.

Outputs

countnumber
How many observations are returned.
first_periodtext
The series' first period. Empty when it has none.
from_periodtext
The period From fell in, e.g. 2024-Q1. Empty without From.
last_periodtext
The series' last period. Empty when it has none.
latestobject
The series' most recent observation with a value, whatever the range. Empty when it has no value yet.
left_out_countnumber
How many periods in the range were not returned (no value, or past Maximum observations).
notetext
What was left out and why, in a sentence.
observationslist
The observations in the range.
seriesobject
The series the observations belong to.
to_periodtext
The period To fell in. Empty without To.
total_in_rangenumber
How many periods fall in the range, with or without a value.
Example output
{
  "count": 2,
  "first_period": "1956",
  "from_period": "2023",
  "last_period": "2024",
  "latest": {
    "date": "2024-01-01",
    "period": "2024",
    "value": 1.99904942291464
  },
  "left_out_count": 0,
  "note": "All 2 observations in the range are included.",
  "observations": [
    {
      "date": "2023-01-01",
      "period": "2023",
      "value": 4.87835726508438
    },
    {
      "date": "2024-01-01",
      "period": "2024",
      "value": 1.99904942291464
    }
  ],
  "series": {
    "code": "A.FR.PCPI_PC_CP_A_PT",
    "dataset_code": "CPI",
    "dataset_name": "Consumer Price Index (CPI)",
    "dimension_labels": {
      "Frequency": "Annual",
      "Indicator": "Consumer Price Index, All items, Percentage change, Previous year",
      "Reference Area": "France"
    },
    "dimensions": {
      "FREQ": "A",
      "INDICATOR": "PCPI_PC_CP_A_PT",
      "REF_AREA": "FR"
    },
    "frequency": "Annual",
    "id": "IMF/CPI/A.FR.PCPI_PC_CP_A_PT",
    "last_updated_at": "2025-08-31T11:54:51Z",
    "name": "Annual \u2013 France \u2013 Consumer Price Index, All items, Percentage change, Previous year",
    "provider_code": "IMF",
    "provider_name": "International Monetary Fund",
    "url": "https://db.nomics.world/IMF/CPI/A.FR.PCPI_PC_CP_A_PT"
  },
  "to_period": "2024",
  "total_in_range": 2
}

Get the latest value

Get a time series' most recent value (the latest inflation rate, interest rate or exchange rate) with its period, the value before it and the change between them, ready to put in a message.

Inputs

Providerprovider_codetext
The provider, to pick the series from a list. Leave empty when Series is a full ID or a link.
Datasetdataset_codetext
The dataset, to pick the series from a list. Leave empty when Series is a full ID or a link.
SeriesseriestextRequired
The series. Pick it from the list (a dataset's first 500 series), or paste its ID or the address of its page on db.nomics.world, like IMF/CPI/A.FR.PCPI_IX. List series finds the ID of any other.

Outputs

changenumber
The latest value minus the one before it. Empty without both.
dataset_codetext
The dataset's code.
dataset_nametext
The dataset's name.
datetext
The day that period starts, YYYY-MM-DD.
frequencytext
How often it has a value: Annual, Quarterly, Monthly, Daily...
has_valuetrue/false
False when the series has no value at all yet.
last_updated_attext
When DBnomics last loaded new data for it, as an ISO 8601 UTC instant, e.g. 2026-10-17T01:31:37Z.
percent_changenumber
That change as a percentage of the value before it, e.g. -59.02. Empty when the value before was 0.
periodtext
The most recent period with a value, e.g. 2024 or 2026-09. Empty when the series has no value yet.
previous_datetext
The day that period starts, YYYY-MM-DD.
previous_periodtext
The period before it that has a value. Empty when there is none.
previous_valuenumber
The value before the latest one. Empty when there is none.
provider_codetext
The provider's code.
provider_nametext
The provider's name. Empty in Get latest values for several series.
series_idtext
The series' full ID, e.g. IMF/CPI/A.FR.PCPI_IX.
series_nametext
The series' name.
urltext
The series' page on db.nomics.world.
valuenumber
The most recent value. Empty when the series has no value yet.
Example output
{
  "change": -2.8793078422,
  "dataset_code": "CPI",
  "dataset_name": "Consumer Price Index (CPI)",
  "date": "2024-01-01",
  "frequency": "Annual",
  "has_value": true,
  "last_updated_at": "2025-08-31T11:54:51Z",
  "percent_change": -59.0221,
  "period": "2024",
  "previous_date": "2023-01-01",
  "previous_period": "2023",
  "previous_value": 4.87835726508438,
  "provider_code": "IMF",
  "provider_name": "International Monetary Fund",
  "series_id": "IMF/CPI/A.FR.PCPI_PC_CP_A_PT",
  "series_name": "Annual \u2013 France \u2013 Consumer Price Index, All items, Percentage change, Previous year",
  "url": "https://db.nomics.world/IMF/CPI/A.FR.PCPI_PC_CP_A_PT",
  "value": 1.99904942291464
}

List a provider's datasets

List the datasets a provider publishes, in its own catalogue's order and with the group each is filed under, optionally only those whose name contains some text. A page at a time.

Inputs

Providerprovider_codetextRequired
The statistics office, central bank or organisation that publishes the data.
Searchsearchtext
Only datasets whose name or code contains this, e.g. inflation.
Number of datasetslimitnumber
How many to return, 1 to 1,000. 100 by default.From 1 to 1000. Default: 100.
Skipoffsetnumber
How many to skip, to get the next page: use next_offset from the last one.At least 0. Default: 0.

Outputs

countnumber
How many are in this page.
datasetslist
The datasets in this page.
has_moretrue/false
True when more follow this page.
next_offsetnumber
The Skip value for the next page. Empty on the last page.
provider_codetext
The provider's code.
provider_nametext
The provider's name.
searchtext
The search text that was applied, if any.
total_countnumber
How many match in all, across every page.
Example output
{
  "count": 1,
  "datasets": [
    {
      "category": null,
      "code": "CPI",
      "id": "IMF/CPI",
      "name": "Consumer Price Index (CPI)",
      "url": "https://db.nomics.world/IMF/CPI"
    }
  ],
  "has_more": true,
  "next_offset": 1,
  "provider_code": "IMF",
  "provider_name": "International Monetary Fund",
  "search": "price",
  "total_count": 2
}

List providers

See every statistics office, central bank and international organisation DBnomics collects data from (about 90, such as the IMF, Eurostat and the Fed), with its region, website, terms of use and when its data last changed.

Inputs

Searchsearchtext
Only providers whose name, code or region contains this, e.g. bank or FR.
Ordersorttext
By name, or the ones with the newest data first.One of: name (By name), recently_updated (Most recently updated first). Default: name.

Outputs

countnumber
How many providers are listed.
providerslist
The providers.
searchtext
The search text that was applied, if any.
sorttext
The order applied: name or recently_updated.
Example output
{
  "count": 1,
  "providers": [
    {
      "code": "IMF",
      "last_updated_at": "2025-09-04T02:25:25Z",
      "name": "International Monetary Fund",
      "region": "World",
      "terms_of_use_url": "http://datahelp.imf.org/tos",
      "url": "https://db.nomics.world/IMF",
      "website": "https://www.imf.org/"
    }
  ],
  "search": "monetary",
  "sort": "name"
}

List recently updated datasets

See which datasets DBnomics loaded new data for most recently, newest first: across every provider or for one, and optionally only since a date. Run it on a schedule to hear about new releases.

Inputs

Providerprovider_codetext
Only this provider's datasets. Leave empty for every provider.
Updated sincesincedate
Only datasets updated on or after this day (UTC).
Number of datasetslimitnumber
How many to return, 1 to 500. 50 by default.From 1 to 500. Default: 50.

Outputs

countnumber
How many datasets are listed.
datasetslist
The datasets, most recently updated first.
latest_updated_attext
The newest update among them, as an ISO 8601 UTC instant.
notetext
Why the list may be incomplete. Empty when it is not.
provider_codetext
The provider asked for, if any.
scan_limit_reachedtrue/false
True when the search stopped at 1,000 updates (about ten days) before reaching Updated since or filling the page, so older matches may exist.
scanned_back_totext
The oldest update looked at, as an ISO 8601 UTC instant.
scanned_countnumber
How many recent updates were looked through.
sincetext
The Updated since day applied, YYYY-MM-DD, if any.
Example output
{
  "count": 1,
  "datasets": [
    {
      "code": "H15",
      "id": "FED/H15",
      "last_updated_at": "2026-10-17T01:31:37Z",
      "name": "Selected Interest Rates",
      "provider_code": "FED",
      "provider_name": "Federal Reserve Board of Governors",
      "series_count": 124,
      "source_updated_at": null,
      "url": "https://db.nomics.world/FED/H15"
    }
  ],
  "latest_updated_at": "2026-10-17T01:31:37Z",
  "note": null,
  "provider_code": "FED",
  "scan_limit_reached": false,
  "scanned_back_to": "2026-10-09T22:10:23Z",
  "scanned_count": 300,
  "since": "2026-10-15"
}

List series in a dataset

Find the series in a dataset: narrow them by dimension (a country, an indicator, a frequency...) and by words in their names, and optionally get each one's latest value. Returns each series' full ID for the other steps. A page at a time.

Inputs

Providerprovider_codetextRequired
The statistics office, central bank or organisation that publishes the data.
Datasetdataset_codetextRequired
The dataset. Pick it once a provider is chosen, or type its code, like CPI.
Dimension filtersdimensionsobject
Pick a value for each dimension to narrow by, such as a country or an indicator; leave the rest empty. To match several values of one dimension, type their codes separated by commas.
Searchsearchtext
Only series whose name or code contains these words, e.g. France.
Include latest valuesinclude_latest_valuestrue/false
Also return each series' most recent value. Slower: at most 50 series at a time.Default: false.
Number of serieslimitnumber
How many to return, 1 to 1,000 (50 with latest values). 50 by default.From 1 to 1000. Default: 50.
Skipoffsetnumber
How many to skip, to get the next page: use next_offset from the last one.At least 0. Default: 0.

Outputs

countnumber
How many are in this page.
dataset_idtext
The dataset's ID, e.g. IMF/CPI.
dataset_nametext
The dataset's name.
filtersobject
The dimension filters applied, by name, e.g. {"Reference Area": ["France"]}.
has_moretrue/false
True when more follow this page.
next_offsetnumber
The Skip value for the next page. Empty on the last page.
searchtext
The search text that was applied, if any.
serieslist
The series in this page.
total_countnumber
How many match in all, across every page.
Example output
{
  "count": 1,
  "dataset_id": "IMF/CPI",
  "dataset_name": "Consumer Price Index (CPI)",
  "filters": {
    "Frequency": [
      "Annual"
    ],
    "Reference Area": [
      "France"
    ]
  },
  "has_more": true,
  "next_offset": 1,
  "search": null,
  "series": [
    {
      "code": "A.FR.PCPI_PC_CP_A_PT",
      "dataset_code": "CPI",
      "dataset_name": "Consumer Price Index (CPI)",
      "dimension_labels": {
        "Frequency": "Annual",
        "Indicator": "Consumer Price Index, All items, Percentage change, Previous year",
        "Reference Area": "France"
      },
      "dimensions": {
        "FREQ": "A",
        "INDICATOR": "PCPI_PC_CP_A_PT",
        "REF_AREA": "FR"
      },
      "frequency": "Annual",
      "id": "IMF/CPI/A.FR.PCPI_PC_CP_A_PT",
      "latest_date": "2024-01-01",
      "latest_period": "2024",
      "latest_value": 1.99904942291464,
      "name": "Annual \u2013 France \u2013 Consumer Price Index, All items, Percentage change, Previous year",
      "provider_code": "IMF",
      "url": "https://db.nomics.world/IMF/CPI/A.FR.PCPI_PC_CP_A_PT"
    }
  ],
  "total_count": 78
}

Search datasets

Search every provider's datasets by words in their names, descriptions and series, such as unemployment France, and see how many of each dataset's series match. List series then finds the series inside one.

Inputs

Search forquerytextRequired
Words to look for in dataset names, descriptions and series, e.g. unemployment France.
Number of resultslimitnumber
How many to return, 1 to 100. 20 by default.From 1 to 100. Default: 20.
Skipoffsetnumber
How many to skip, to get the next page: use next_offset from the last one.At least 0. Default: 0.

Outputs

countnumber
How many are in this page.
datasetslist
The matching datasets in this page, best first.
has_moretrue/false
True when more follow this page.
next_offsetnumber
The Skip value for the next page. Empty on the last page.
querytext
The words searched for.
total_countnumber
How many match in all, across every page.
Example output
{
  "count": 1,
  "datasets": [
    {
      "code": "IPC-2025",
      "description": null,
      "id": "INSEE/IPC-2025",
      "last_updated_at": "2026-10-15T06:58:08Z",
      "matching_series_count": 3851,
      "name": "Consumer price index",
      "provider_code": "INSEE",
      "provider_name": "Institut national de la statistique et des \u00e9tudes \u00e9conomiques",
      "series_count": 4523,
      "source_updated_at": "2026-10-15T00:00:00Z",
      "url": "https://db.nomics.world/INSEE/IPC-2025"
    }
  ],
  "has_more": true,
  "next_offset": 1,
  "query": "consumer prices france",
  "total_count": 141
}

On this page