Skip to main content
Use the cdf data download command to download data from Cognite Data Fusion (CDF) to your local machine. This command provides multiple subcommands for downloading different types of data, including raw tables, assets, time series, events, files, hierarchies, instances, and charts. All subcommands have an interactive prompt if you do not specify any arguments, making it easy to select what you want to download.

​
Prerequisites

Before downloading data, ensure you have:
  • Installed and configured the Cognite Toolkit.
  • Authenticated with CDF using appropriate credentials.
  • Read permissions for the data you want to download.
  • Sufficient disk space for the downloaded files.

​
Download data

1

Run the interactive download

To download data interactively, run the command for your specific data type without arguments. For example, for raw tables:
cdf data download raw
Follow the prompts to select which raw tables you want to download.
2

Specify resources directly (optional)

Alternatively, you can specify the resources directly in the command line. For example, to download specific tables from a database:
cdf data download raw my_table1 my_table2 --database my_database

​
Supported data types

The following data types are currently supported for download:
  • Raw tables
  • Assets
  • Time series
  • Events
  • Files (with file content requires extend-download alpha flag enabled)
  • Hierarchies (assets, events, time series, and files)
  • Instances
  • Charts
  • Canvases
  • Datapoints (requires extend-download alpha flag enabled)
For an up-to-date list of available data types and their arguments, use the cdf data download --help command.

​
Further reading

Last modified on January 28, 2026