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
| Action | What it does |
|---|---|
| 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. |
| 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. |
| 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). |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
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
- Provider
provider_codetextRequired - The statistics office, central bank or organisation that publishes the data.
- Dataset
dataset_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
- Provider
provider_codetextRequired - The statistics office, central bank or organisation that publishes the data.
- Dataset
dataset_codetextRequired - The dataset. Pick it once a provider is chosen, or type its code, like CPI.
- Dimension
dimensiontext - Only this dimension. Leave empty for all of them.
- Search values
searchtext - Only values whose name or code contains this, e.g. France.
- Values per dimension
max_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
- Provider
provider_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
- Series
serieslistRequired - 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
- Provider
provider_codetext - The provider, to pick the series from a list. Leave empty when Series is a full ID or a link.
- Dataset
dataset_codetext - The dataset, to pick the series from a list. Leave empty when Series is a full ID or a link.
- Series
seriestextRequired - 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.
- From
from_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.
- To
to_datedate - Only periods that start on or before this date.
- Order
ordertext - Oldest first by default.One of:
oldest_first(Oldest first),newest_first(Newest first). Default:oldest_first. - Include periods with no value
include_missingtrue/false - Also return periods the provider has no value for, with an empty value. Off by default.Default:
false. - Maximum observations
max_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
- Provider
provider_codetext - The provider, to pick the series from a list. Leave empty when Series is a full ID or a link.
- Dataset
dataset_codetext - The dataset, to pick the series from a list. Leave empty when Series is a full ID or a link.
- Series
seriestextRequired - 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
- Provider
provider_codetextRequired - The statistics office, central bank or organisation that publishes the data.
- Search
searchtext - Only datasets whose name or code contains this, e.g. inflation.
- Number of datasets
limitnumber - How many to return, 1 to 1,000. 100 by default.From 1 to 1000. Default:
100. - Skip
offsetnumber - 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
- Search
searchtext - Only providers whose name, code or region contains this, e.g. bank or FR.
- Order
sorttext - 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
- Provider
provider_codetext - Only this provider's datasets. Leave empty for every provider.
- Updated since
sincedate - Only datasets updated on or after this day (UTC).
- Number of datasets
limitnumber - 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
- Provider
provider_codetextRequired - The statistics office, central bank or organisation that publishes the data.
- Dataset
dataset_codetextRequired - The dataset. Pick it once a provider is chosen, or type its code, like CPI.
- Dimension filters
dimensionsobject - 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.
- Search
searchtext - Only series whose name or code contains these words, e.g. France.
- Include latest values
include_latest_valuestrue/false - Also return each series' most recent value. Slower: at most 50 series at a time.Default:
false. - Number of series
limitnumber - How many to return, 1 to 1,000 (50 with latest values). 50 by default.From 1 to 1000. Default:
50. - Skip
offsetnumber - 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 for
querytextRequired - Words to look for in dataset names, descriptions and series, e.g. unemployment France.
- Number of results
limitnumber - How many to return, 1 to 100. 20 by default.From 1 to 100. Default:
20. - Skip
offsetnumber - 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
}