# DBnomics

> 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.

App · 11 actions. Web page: https://docs.lodol.com/docs/integrations/dbnomics

## Actions

### 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_code`, text, required): The statistics office, central bank or organisation that publishes the data.
- Dataset (`dataset_code`, text, required): The dataset. Pick it once a provider is chosen, or type its code, like CPI.

**Outputs**

- `dataset` (object): A dataset and what it holds.

**Example output**

```json
{
  "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_code`, text, required): The statistics office, central bank or organisation that publishes the data.
- Dataset (`dataset_code`, text, required): The dataset. Pick it once a provider is chosen, or type its code, like CPI.
- Dimension (`dimension`, text): Only this dimension. Leave empty for all of them.
- Search values (`search`, text): Only values whose name or code contains this, e.g. France.
- Values per dimension (`max_values`, number): 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**

- `count` (number): How many dimensions are listed.
- `dataset_id` (text): The dataset's ID, e.g. IMF/CPI.
- `dataset_name` (text): The dataset's name.
- `dimensions` (list): The dimensions, in the order series codes use them.
- `search` (text): The value search that was applied, if any.

**Example output**

```json
{
  "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_code`, text, required): The statistics office, central bank or organisation that publishes the data.

**Outputs**

- `provider` (object): A statistics office, central bank or organisation DBnomics collects from.

**Example output**

```json
{
  "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 (`series`, list, required): 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**

- `count` (number): How many series were found.
- `not_found` (list): The series IDs DBnomics does not have.
- `not_found_count` (number): How many series IDs were not found.
- `series` (list): Each series found, in the order given.

**Example output**

```json
{
  "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_code`, text): The provider, to pick the series from a list. Leave empty when Series is a full ID or a link.
- Dataset (`dataset_code`, text): The dataset, to pick the series from a list. Leave empty when Series is a full ID or a link.
- Series (`series`, text, required): 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_date`, date): 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_date`, date): Only periods that start on or before this date.
- Order (`order`, text): Oldest first by default. One of: `oldest_first` (Oldest first), `newest_first` (Newest first). Default: `oldest_first`.
- Include periods with no value (`include_missing`, true/false): Also return periods the provider has no value for, with an empty value. Off by default. Default: `false`.
- Maximum observations (`max_observations`, number): 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**

- `count` (number): How many observations are returned.
- `first_period` (text): The series' first period. Empty when it has none.
- `from_period` (text): The period From fell in, e.g. 2024-Q1. Empty without From.
- `last_period` (text): The series' last period. Empty when it has none.
- `latest` (object): The series' most recent observation with a value, whatever the range. Empty when it has no value yet.
- `left_out_count` (number): How many periods in the range were not returned (no value, or past Maximum observations).
- `note` (text): What was left out and why, in a sentence.
- `observations` (list): The observations in the range.
- `series` (object): The series the observations belong to.
- `to_period` (text): The period To fell in. Empty without To.
- `total_in_range` (number): How many periods fall in the range, with or without a value.

**Example output**

```json
{
  "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_code`, text): The provider, to pick the series from a list. Leave empty when Series is a full ID or a link.
- Dataset (`dataset_code`, text): The dataset, to pick the series from a list. Leave empty when Series is a full ID or a link.
- Series (`series`, text, required): 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**

- `change` (number): The latest value minus the one before it. Empty without both.
- `dataset_code` (text): The dataset's code.
- `dataset_name` (text): The dataset's name.
- `date` (text): The day that period starts, YYYY-MM-DD.
- `frequency` (text): How often it has a value: Annual, Quarterly, Monthly, Daily...
- `has_value` (true/false): False when the series has no value at all yet.
- `last_updated_at` (text): When DBnomics last loaded new data for it, as an ISO 8601 UTC instant, e.g. 2026-10-17T01:31:37Z.
- `percent_change` (number): That change as a percentage of the value before it, e.g. -59.02. Empty when the value before was 0.
- `period` (text): The most recent period with a value, e.g. 2024 or 2026-09. Empty when the series has no value yet.
- `previous_date` (text): The day that period starts, YYYY-MM-DD.
- `previous_period` (text): The period before it that has a value. Empty when there is none.
- `previous_value` (number): The value before the latest one. Empty when there is none.
- `provider_code` (text): The provider's code.
- `provider_name` (text): The provider's name. Empty in Get latest values for several series.
- `series_id` (text): The series' full ID, e.g. IMF/CPI/A.FR.PCPI_IX.
- `series_name` (text): The series' name.
- `url` (text): The series' page on db.nomics.world.
- `value` (number): The most recent value. Empty when the series has no value yet.

**Example output**

```json
{
  "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_code`, text, required): The statistics office, central bank or organisation that publishes the data.
- Search (`search`, text): Only datasets whose name or code contains this, e.g. inflation.
- Number of datasets (`limit`, number): How many to return, 1 to 1,000. 100 by default. From 1 to 1000. Default: `100`.
- Skip (`offset`, number): How many to skip, to get the next page: use next_offset from the last one. At least 0. Default: `0`.

**Outputs**

- `count` (number): How many are in this page.
- `datasets` (list): The datasets in this page.
- `has_more` (true/false): True when more follow this page.
- `next_offset` (number): The Skip value for the next page. Empty on the last page.
- `provider_code` (text): The provider's code.
- `provider_name` (text): The provider's name.
- `search` (text): The search text that was applied, if any.
- `total_count` (number): How many match in all, across every page.

**Example output**

```json
{
  "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 (`search`, text): Only providers whose name, code or region contains this, e.g. bank or FR.
- Order (`sort`, text): By name, or the ones with the newest data first. One of: `name` (By name), `recently_updated` (Most recently updated first). Default: `name`.

**Outputs**

- `count` (number): How many providers are listed.
- `providers` (list): The providers.
- `search` (text): The search text that was applied, if any.
- `sort` (text): The order applied: name or recently_updated.

**Example output**

```json
{
  "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_code`, text): Only this provider's datasets. Leave empty for every provider.
- Updated since (`since`, date): Only datasets updated on or after this day (UTC).
- Number of datasets (`limit`, number): How many to return, 1 to 500. 50 by default. From 1 to 500. Default: `50`.

**Outputs**

- `count` (number): How many datasets are listed.
- `datasets` (list): The datasets, most recently updated first.
- `latest_updated_at` (text): The newest update among them, as an ISO 8601 UTC instant.
- `note` (text): Why the list may be incomplete. Empty when it is not.
- `provider_code` (text): The provider asked for, if any.
- `scan_limit_reached` (true/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_to` (text): The oldest update looked at, as an ISO 8601 UTC instant.
- `scanned_count` (number): How many recent updates were looked through.
- `since` (text): The Updated since day applied, YYYY-MM-DD, if any.

**Example output**

```json
{
  "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_code`, text, required): The statistics office, central bank or organisation that publishes the data.
- Dataset (`dataset_code`, text, required): The dataset. Pick it once a provider is chosen, or type its code, like CPI.
- Dimension filters (`dimensions`, object): 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 (`search`, text): Only series whose name or code contains these words, e.g. France.
- Include latest values (`include_latest_values`, true/false): Also return each series' most recent value. Slower: at most 50 series at a time. Default: `false`.
- Number of series (`limit`, number): How many to return, 1 to 1,000 (50 with latest values). 50 by default. From 1 to 1000. Default: `50`.
- Skip (`offset`, number): How many to skip, to get the next page: use next_offset from the last one. At least 0. Default: `0`.

**Outputs**

- `count` (number): How many are in this page.
- `dataset_id` (text): The dataset's ID, e.g. IMF/CPI.
- `dataset_name` (text): The dataset's name.
- `filters` (object): The dimension filters applied, by name, e.g. {"Reference Area": ["France"]}.
- `has_more` (true/false): True when more follow this page.
- `next_offset` (number): The Skip value for the next page. Empty on the last page.
- `search` (text): The search text that was applied, if any.
- `series` (list): The series in this page.
- `total_count` (number): How many match in all, across every page.

**Example output**

```json
{
  "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 (`query`, text, required): Words to look for in dataset names, descriptions and series, e.g. unemployment France.
- Number of results (`limit`, number): How many to return, 1 to 100. 20 by default. From 1 to 100. Default: `20`.
- Skip (`offset`, number): How many to skip, to get the next page: use next_offset from the last one. At least 0. Default: `0`.

**Outputs**

- `count` (number): How many are in this page.
- `datasets` (list): The matching datasets in this page, best first.
- `has_more` (true/false): True when more follow this page.
- `next_offset` (number): The Skip value for the next page. Empty on the last page.
- `query` (text): The words searched for.
- `total_count` (number): How many match in all, across every page.

**Example output**

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