FITSTATS' OneRoster import API automates the data upload and update process. While this process provides a extremely effective way to manage data, the initial setup has to be done by your IT specialist. Please contact us for further information.

To import OneRoster® 1.0 or 1.1 ZIP file, run the following script:
curl -F api_key=YOUR_API_KEY -F file=@YOUR_FILE

The script can be run every day via a cron job ran on your server.


Curl is an open-source tool and library used for transferring data. Curl can be downloaded from Additionally you will probably want to add curl to your PATH environment variable.

Alternatively on Linux you should be able to install curl via your package manager (yum, apt-get, etc). You may use a tool other than Curl to upload your data to the FITSTATS API. That is outside the scope of this document however. The support FITSTATS is able to provide should you encounter problems may be limited.

Finding your API Key

Log into FITSTATS using the owner account.

Go to the owner’s profile (top right):






Click the gear icon:


Here you can see your API key as well as a template file for the OneRoster import.

If you do not see this icon please confirm that you are logged in as the account owner. If you still do not see the option please contact FITSTATS support and ask them to check that the Import API is enabled for your account.

File Formats

The import files you upload to FITSTATS (@YOUR_FILE)  must be a valid OneRoster® 1.0 or 1.1 ZIP file.

The same data can safely be imported multiple times. FITSTATS will attempt to match the data to existing records and update them instead of creating new ones where possible.