Reference data download script

For easily download of reference data and installers we provide a python script.

The script will download the reference data based on your subscription and the necessary installer(s) for your platform.

How to get the download script?

You can download the script in the Download Service section of Uniserv Connect or directly here.

Why do you need the download script?

The script is a good choice if you don’t want to download reference data via browser and wish to automate your download process.

What is the script doing in detail?

The download script downloads the latest versions of reference data that have not been previously downloaded, thus reducing bandwidth usage and accelerating the download process. To achieve this, it compares the downloaded artifacts with the sha512 artifacts stored remotely. If the artifacts match, the script avoids redundant downloads.

For successful artifact comparison, ensure that the previously downloaded artifacts are located in the same directory as the download script.

Upon completion of the download process, a file named "downloadedFiles.txt" is automatically generated. This file contains the names of the downloaded artifacts, with each artifact listed on a separate line. This feature provides a convenient record of the downloaded files.


In case of issues during script execution, refer to the Error messages or contact our support for assistance.


  • Python 3.10 or higher

  • Uniserv API Key (to generate an API Key, see API Key)


python3 --api-key <your-api-key> [--installer <installer name, e.g. setupRefdata_linux_x64>]


python --api-key <your-api-key> [--installer <installer name, e.g. setupRefdata_linux_x64>]
The name of the python executable (python3 or python) depends on your operating system and your installation.


The script offers the following arguments.




Show a description how to use the script.


Mandatory argument. The API Key to use to access reference data download resources.


Specify the installer for your platform. For available installers, see

If not specified, all installers will be downloaded.


Set a proxy to use. Specify the host name or the IP address of the proxy server, optionally followed by a colon and a port number.



Set the protocol to use to connect to the proxy server.

Possible values: http or https


Specify the username to use if proxy authentication is required.


Specify the password to use if proxy authentication is required.


Print the current version of the script.

Verifying downloaded files

After the script has been executed, it may be desired to verify whether any files were successfully downloaded. This can be achieved by examining the script’s exit status code and checking for the presence of the "downloadedFiles.txt" file.

Below is an example shell snippet demonstrating how to conduct this verification:

# Check the exit status code of the script
if [ $? -eq 0 ] && [ -f downloadedFiles.txt ]; then
      # Execution successful. New reference data downloaded
      # Further scripts or actions can be placed here

Exit Status Codes

Status code



script executed successfully (also including the case, all downloads were skipped due to up-to-date reference data)


error occurred during script execution